Tạo tác vụ
Yêu cầu video thường gồm prompt, model và các thuộc tính khung hình như thời lượng, tỷ lệ khung hình, độ phân giải hoặc tham chiếu, chỉ khi mô hình đã chọn hỗ trợ.
Lưu ID tác vụ ngay lập tức. ID này cần để hiển thị tiến độ, hỗ trợ hủy trong giao diện và lấy nội dung cuối cùng.
Tác vụ tạo video
bash
curl --request POST https://cicora.ai/api/v1/videos \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "google/veo-3.1",
"prompt": "Slow aerial movement above a river at sunrise",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}'Thăm dò trạng thái
- Đọc tác vụ qua GET /videos/{video_id}.
- Xem trạng thái kết thúc là nguồn chính xác về việc hoàn thành.
- Dùng khoảng thăm dò tăng dần và dừng thăm dò khi người dùng rời đi.
Làm việc với kết quả
Sau khi hoàn tất, dùng URL hoặc nội dung do tác vụ trả về và xác minh tệp đã sẵn sàng trước khi hiển thị trình phát.
Lưu câu lệnh, mô hình, tham số và ID tác vụ để hỗ trợ, nhưng không lưu tham chiếu đầu vào lâu hơn nhu cầu của sản phẩm.