Video Generation (Asynchronous)

Tạo video tốn khá nhiều thời gian (từ hàng chục giây đến vài phút), 4ALL API sử dụng giao thức bất đồng bộ gửi yêu cầu + thăm dò: Trước tiên gửi tác vụ để nhận task_id, sau đó thăm dò để truy vấn kết quả.

1. Gửi tác vụ

POST https://api.4allapi.com/v1/video/generations

curl https://api.4allapi.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -d '{
    "model": "veo-3.1",
    "prompt": "Góc nhìn từ drone lướt qua bờ biển buổi sớm, phong cách điện ảnh, ánh sáng tự nhiên",
    "size": "1280x720",
    "seconds": "8"
  }'

Phản hồi:

{ "task_id": "video-task-xxx", "status": "submitted" }

Tham số	Mô tả
`model`	Mô hình video, như `veo-3.1`, `sora-2`, `kling-v3`, `omni-flash`
`prompt`	Mô tả khung hình và chuyển động máy quay
`size`	Độ phân giải (ngang/dọc), theo phạm vi được mô hình hỗ trợ
`seconds`	Thời lượng (giây), theo phạm vi được mô hình hỗ trợ
`image`	Ảnh tham chiếu khung hình đầu tiên cho video từ ảnh sang video (các mô hình được hỗ trợ, URL hoặc base64)

2. Truy vấn kết quả

GET https://api.4allapi.com/v1/video/generations/{task_id}

curl https://api.4allapi.com/v1/video/generations/video-task-xxx \
  -H "Authorization: Bearer $AIPROXY_KEY"

status sẽ trải qua submitted → processing → succeeded / failed; khi thành công sẽ trả về địa chỉ tải xuống video:

{
  "task_id": "video-task-xxx",
  "status": "succeeded",
  "video_url": "https://.../result.mp4"
}

Gợi ý thăm dò

Thăm dò mỗi 5–10 giây một lần, tổng thời gian chờ nên nới rộng theo thời lượng của mô hình (ví dụ 10 phút);
Trạng thái failed sẽ đi kèm lý do thất bại, nếu thất bại do vi phạm nội dung hãy điều chỉnh prompt rồi gửi lại;
Liên kết video có thời hạn sử dụng, sau khi tạo thành công hãy lưu chuyển sang bộ nhớ của riêng bạn càng sớm càng tốt.