#Video

Quá trình tạo video diễn ra bất đồng bộ. Hãy tạo một tác vụ, lưu ID, kiểm tra định kỳ trạng thái tác vụ và tải kết quả xuống sau khi hoàn tất.

Các endpoint video chung là:

POST /v1/videos
GET  /v1/videos/{task_id}
GET  /v1/videos/{task_id}/content

#Tạo tác vụ video

Endpoint /v1/videos chấp nhận dữ liệu biểu mẫu multipart:

curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=A paper airplane flying through a quiet modern office" \
  -F "seconds=8"

Với đầu vào hình ảnh thành video, hãy thêm một tệp tham chiếu khi model hỗ trợ:

curl https://getrouter.ai/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_ID" \
  -F "prompt=Add a slow camera push and subtle movement" \
  -F "seconds=8" \
  -F "[email protected]"

Phản hồi thành công gồm mã định danh tác vụ như id, cùng siêu dữ liệu tác vụ như trạng thái, tiến độ, model, thời lượng hoặc dấu thời gian nếu có.

#Kiểm tra trạng thái tác vụ

curl https://getrouter.ai/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Thăm dò theo khoảng thời gian hợp lý. Dừng thăm dò khi tác vụ đạt trạng thái kết thúc thành công hoặc thất bại.

#Tải kết quả xuống

Sau khi tác vụ hoàn tất:

curl -L https://getrouter.ai/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output result.mp4

#Quy trình tác vụ nên dùng

1. Xác thực model, thời lượng và đầu vào trước khi gửi.
2. Chỉ gửi tác vụ một lần.
3. Lưu lại ID tác vụ được trả về.
4. Thăm dò với thời gian chờ tăng dần thay vì gửi yêu cầu liên tục trong thời gian ngắn.
5. Ghi lại lỗi ở trạng thái kết thúc để khắc phục sự cố.
6. Tải xuống kịp thời nội dung đã hoàn tất.

#API video dành riêng cho nhà cung cấp

Đặc tả API cũng gồm các đường dẫn video tương thích với nhà cung cấp, bao gồm định dạng kiểu Kling và các định dạng tác vụ khác. Trường yêu cầu và phản hồi trạng thái khác nhau giữa các endpoint này. Với tích hợp mới, hãy dùng quy trình chung /v1/videos, trừ khi một model hoặc client hiện có yêu cầu đường dẫn dành riêng cho nhà cung cấp.

Xem Tài liệu tham chiếu API để biết các đường dẫn và lược đồ hiện được cung cấp.

#Kiểm soát chi phí

Chi phí video có thể phụ thuộc vào model, thời lượng, độ phân giải, chất lượng hoặc loại đầu vào. Hãy xem Giá và bắt đầu bằng các tác vụ thử nghiệm ngắn trước khi chạy theo lô tự động.

#Bước tiếp theo

• Duyệt model video
• Xem giá
• Mở Tài liệu tham chiếu API