เอกสารอ้างอิง API
เอกสาร API ฉบับสมบูรณ์สำหรับการสร้างวิดีโอ Veo 3.1 AI
ภาพรวม
Veo 3.1 API ช่วยให้คุณสร้างวิดีโอ AI โดยโปรแกรมจากคำอธิบายข้อความหรือรูปภาพ RESTful API ของเราได้รับการออกแบบให้เรียบง่าย ทรงพลัง และง่ายต่อการรวมเข้ากับแอปพลิเคชันของคุณ
URL พื้นฐาน
https://veo3o1.com/apiการยืนยันตัวตน
คำขอ API ทั้งหมดต้องมีการยืนยันตัวตนโดยใช้คีย์ API รวมคีย์ API ของคุณในส่วนหัว Authorization:
Authorization: Bearer YOUR_API_KEYคุณสามารถสร้างคีย์ API ได้จากแดชบอร์ดบัญชีของคุณ
สร้างวิดีโอ
สร้างวิดีโอ AI ใหม่จากข้อความหรือรูปภาพ
Endpoint
POST /generate-videoเนื้อหาคำขอ
{
"generationType": "text_to_video" | "image_to_video",
"prompt": "Your video description",
"aspectRatio": "auto" | "16:9" | "9:16",
"imageUrl": "https://...", // Required if generationType is "image_to_video"
"imageKey": "r2-key" // Optional, for uploaded images
}พารามิเตอร์
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
generationType | string | ใช่ | ประเภทการสร้าง: text_to_video หรือ image_to_video |
prompt | string | ใช่ | คำอธิบายวิดีโอที่คุณต้องการสร้าง |
aspectRatio | string | ไม่ | อัตราส่วนภาพวิดีโอ ค่าเริ่มต้น: auto |
imageUrl | string | มีเงื่อนไข | จำเป็นถ้า generationType เป็น image_to_video |
imageKey | string | ไม่ | คีย์จัดเก็บสำหรับรูปภาพที่อัปโหลด |
การตอบกลับ
{
"code": 0,
"msg": "Success",
"data": {
"uuid": "video-uuid-123",
"status": "pending",
"generationType": "text_to_video",
"prompt": "Your video description",
"aspectRatio": "16:9",
"createdAt": "2025-10-16T10:00:00Z"
}
}ตัวอย่าง
curl -X POST https://veo3o1.com/api/generate-video \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"generationType": "text_to_video",
"prompt": "A beautiful sunset over the ocean with waves gently lapping the shore",
"aspectRatio": "16:9"
}'รับสถานะวิดีโอ
ตรวจสอบสถานะของคำขอสร้างวิดีโอ
Endpoint
GET /video-status/{uuid}พารามิเตอร์
| พารามิเตอร์ | ประเภท | จำเป็น | คำอธิบาย |
|---|---|---|---|
uuid | string | ใช่ | UUID วิดีโอจากคำขอสร้าง |
การตอบกลับ
{
"code": 0,
"msg": "Success",
"data": {
"uuid": "video-uuid-123",
"status": "completed" | "pending" | "processing" | "failed",
"videoUrl": "https://...", // Available when status is "completed"
"progress": 85, // Processing progress (0-100)
"estimatedTime": 120 // Estimated seconds remaining
}
}ค่าสถานะ
pending: วิดีโออยู่ในคิวรอการประมวลผลprocessing: กำลังสร้างวิดีโอcompleted: วิดีโอพร้อมและสามารถดาวน์โหลดได้failed: การสร้างล้มเหลว (ตรวจสอบข้อความแสดงข้อผิดพลาด)
อัปโหลดรูปภาพ
อัปโหลดรูปภาพสำหรับการสร้างวิดีโอจากรูปภาพ
Endpoint
POST /upload-video-imageคำขอ
ใช้ multipart/form-data เพื่ออัปโหลดไฟล์รูปภาพ
curl -X POST https://veo3o1.com/api/upload-video-image \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"การตอบกลับ
{
"code": 0,
"msg": "Upload successful",
"data": {
"imageUrl": "https://...",
"imageKey": "r2-key-123"
}
}รูปแบบที่รองรับ
- JPEG/JPG
- PNG
- WebP
- ขนาดไฟล์สูงสุด: 50MB
รหัสข้อผิดพลาด
| รหัส | คำอธิบาย |
|---|---|
| 0 | สำเร็จ |
| 1000 | พารามิเตอร์ไม่ถูกต้อง |
| 1001 | เครดิตไม่เพียงพอ |
| 1002 | การยืนยันตัวตนล้มเหลว |
| 1003 | เกินขีดจำกัดอัตรา |
| 5000 | ข้อผิดพลาดเซิร์ฟเวอร์ |
ตัวอย่างการตอบกลับข้อผิดพลาด
{
"code": 1001,
"msg": "Insufficient credits",
"data": {
"required": 2,
"current": 0
}
}แนวทางปฏิบัติที่ดีที่สุด
- การ polling อย่างรับผิดชอบ: ตรวจสอบสถานะวิดีโอทุก 5-10 วินาที ไม่ใช่ต่อเนื่อง
- การจัดการข้อผิดพลาด: ใช้ตรรกะการลองใหม่ด้วย exponential backoff
- แคชผลลัพธ์: เก็บวิดีโอที่สร้างแล้วเพื่อหลีกเลี่ยงการสร้างซ้ำ
- ใช้ webhooks: มีประสิทธิภาพมากกว่า polling สำหรับการแจ้งเตือนเมื่อเสร็จสิ้น
- ตรวจสอบอินพุต: ตรวจสอบความยาว prompt และรูปแบบรูปภาพก่อนเรียก API
การสนับสนุน
ต้องการความช่วยเหลือเกี่ยวกับ API?
- 📧 อีเมล: aiprocessingrobot@gmail.com
- 💬 ติดต่อฝ่ายสนับสนุน