建立工作
視訊請求通常包含 prompt、model，以及時長、長寬比、解析度或參照等畫面屬性；只有所選模型支援時才加入這些屬性。
立即保存工作 ID。顯示進度、在介面中支援取消，以及取得最終內容都需要此 ID。
視訊生成工作
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"
}'輪詢狀態
- 透過 GET /videos/{video_id} 讀取工作。
- 將終止狀態視為完成與否的依據。
- 逐步增加輪詢間隔，並在使用者離開時停止輪詢。
處理結果
完成後，使用工作回傳的 URL 或內容，並在顯示播放器前確認檔案已就緒。
請保留 prompt、model、參數與工作 ID 供支援使用，但輸入參照的保留時間不得超過產品所需。