เอกสารอ้างอิง 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
}

พารามิเตอร์

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
generationTypestringใช่ประเภทการสร้าง: text_to_video หรือ image_to_video
promptstringใช่คำอธิบายวิดีโอที่คุณต้องการสร้าง
aspectRatiostringไม่อัตราส่วนภาพวิดีโอ ค่าเริ่มต้น: auto
imageUrlstringมีเงื่อนไขจำเป็นถ้า generationType เป็น image_to_video
imageKeystringไม่คีย์จัดเก็บสำหรับรูปภาพที่อัปโหลด

การตอบกลับ

{
  "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}

พารามิเตอร์

พารามิเตอร์ประเภทจำเป็นคำอธิบาย
uuidstringใช่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
  }
}

แนวทางปฏิบัติที่ดีที่สุด

  1. การ polling อย่างรับผิดชอบ: ตรวจสอบสถานะวิดีโอทุก 5-10 วินาที ไม่ใช่ต่อเนื่อง
  2. การจัดการข้อผิดพลาด: ใช้ตรรกะการลองใหม่ด้วย exponential backoff
  3. แคชผลลัพธ์: เก็บวิดีโอที่สร้างแล้วเพื่อหลีกเลี่ยงการสร้างซ้ำ
  4. ใช้ webhooks: มีประสิทธิภาพมากกว่า polling สำหรับการแจ้งเตือนเมื่อเสร็จสิ้น
  5. ตรวจสอบอินพุต: ตรวจสอบความยาว prompt และรูปแบบรูปภาพก่อนเรียก API

การสนับสนุน

ต้องการความช่วยเหลือเกี่ยวกับ API?