影片生成
提交影片生成任務，查詢處理狀態並讀取生成結果。
概述
AGTCloud 提供多種影片生成模型和呼叫協議。影片請求通常先建立任務，再使用任務識別碼查詢狀態並讀取結果。
支援的任務類型
| 類型 | 說明 | 主要輸入 |
|---|---|---|
| 文生影片 | 根據文字描述生成影片 | Prompt |
| 圖生影片 | 讓靜態圖片產生運動 | Prompt、圖片 |
| 參考素材生成 | 根據模型支援的圖片或影片素材生成內容 | Prompt、參考素材 |
| 模型專屬擴展 | 使用起始與結束影格、運鏡或其他專屬能力 | 以對應模型和協議為準 |
API 串接
Base URL
https://api.agtcloud.cn/v1文生影片
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "一列火車穿過雨後的山谷，鏡頭緩慢向前推進"
}'圖生影片
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"prompt": "保持主體外觀，讓畫面中的人物緩慢走向鏡頭",
"image": "https://example.com/input.jpg"
}'建立成功後，儲存回應中的 Task ID，再使用同一協議查詢任務。
查詢任務
curl 'https://api.agtcloud.cn/v1/video/generations/TASK_ID' \
-H 'Authorization: Bearer your-api-key'選擇呼叫協議
| 協議 | 建立入口 | 後續處理 |
|---|---|---|
| Platform Video Generations | POST /v1/video/generations | 使用 Task ID 查詢結果 |
| OpenAI Videos | POST /v1/videos | 使用 Video ID 查詢並下載內容 |
| 廠商專用協議 | 以對應 Reference 為準 | 使用該協議定義的任務識別碼和狀態 |
同一次任務應始終使用同一協議的建立、查詢和下載路徑。