Veo 3.1 API

Tài liệu tham khảo API đầy đủ cho các mô hình tạo video Veo 3.1.

Các Phiên Bản Mô Hình

API này hỗ trợ bốn phiên bản mô hình:

So Sánh Nhanh

Veo 3.1 Text to Video (Tiêu Chuẩn & Nhanh)

Endpoint

POST /api/v1/video/task

Tham Số Yêu Cầu

Bắt Buộc

Tùy Chọn

Ví Dụ Yêu Cầu

Phiên Bản Tiêu Chuẩn:

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'veo3.1-text-to-video',
    prompt: 'A time-lapse of a flower blooming'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Phiên Bản Nhanh:

javascriptSao chép
{
  model_name: 'veo3.1-fast-text-to-video',
  prompt: 'A time-lapse of a flower blooming'
}

Veo 3.1 Image to Video (Tiêu Chuẩn & Nhanh)

Tham Số Yêu Cầu

Bắt Buộc

Tùy Chọn

Ví Dụ Yêu Cầu

Phiên Bản Tiêu Chuẩn:

javascriptSao chép
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'veo3.1-image-to-video',
    image_url: 'https://example.com/image.jpg',
    prompt: 'Camera slowly zooms in, soft wind movement'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Phiên Bản Nhanh:

javascriptSao chép
{
  model_name: 'veo3.1-fast-image-to-video',
  image_url: 'https://example.com/image.jpg',
  prompt: 'Camera slowly zooms in, soft wind movement'
}

Định Dạng Phản Hồi

Phản Hồi Ban Đầu

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Phản Hồi Polling

Gọi /api/v1/video/{taskId} để kiểm tra trạng thái:

jsonSao chép
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Các Giá Trị Trạng Thái

• submitted: Tác vụ đã được gửi và đang chờ xử lý
• processing: Đang tạo video
• succeed: Tạo video hoàn tất
• failed: Tạo video thất bại

Thời Gian Xử Lý

• Phiên Bản Tiêu Chuẩn: ~2-3 phút
• Phiên Bản Nhanh: ~1-2 phút

Sử dụng polling để kiểm tra trạng thái tạo video mỗi 5-10 giây.

Thực Hành Tốt Nhất

• Mô tả cụ thể về chuyển động camera và động lực cảnh
• Phiên bản nhanh cung cấp chất lượng tốt với xử lý nhanh hơn
• Phiên bản tiêu chuẩn cung cấp đầu ra chất lượng cao nhất
• Sử dụng prompt mô tả chi tiết để có kết quả tốt hơn