影片 API

LLMPool 提供 MiniMax、Doubao、Doubao 擴展協議及阿里雲影片模型。阿里雲接口使用 /aliyun/v1。

認證

使用 Board 建立的帳戶 API 密鑰：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

以下以 https://<LLMPOOL_HOST> 表示服務根地址。影片 API 不使用 /openai/v1 路徑，model 應填寫 模型廣場顯示的模型 ID。建立成功後，每 5-10 秒查詢一次任務，直至成功或失敗。詳情及列表響應在有觀測值時會包含 Unix 秒的 submitted_at、generation_started_at、completed_at、result_available_at。

協議能力

MiniMax

curl -X POST "https://<LLMPOOL_HOST>/minimax/v2/video_generation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: minimax-demo-001" \
  -d '{"model":"MiniMax-H3","content":[{"type":"text","text":"A cinematic city at night"}],"resolution":"768P","duration":5,"ratio":"16:9","seed":42,"aigc_watermark":false}'

MiniMax 支援 768P、4-15 秒，以及文生影片比例 16:9、4:3、1:1。圖生影片可加入一個 image_url，role 為 first_frame，比例使用 adaptive。圖片可以是公開 HTTPS URL 或圖片 data URL。

curl "https://<LLMPOOL_HOST>/minimax/v2/video_generation/video_xxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl "https://<LLMPOOL_HOST>/minimax/v2/video_generation?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X DELETE "https://<LLMPOOL_HOST>/minimax/v2/video_generation/video_xxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

每個列表只返回對應協議的任務，支援 limit、after 及可選的 source=api|playground。只有 queued 任務可以取消；in_progress 任務會返回 task_not_cancellable。終態任務的 DELETE 表示刪除記錄。

Doubao

curl -X POST "https://<LLMPOOL_HOST>/doubao/v1/video/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: doubao-demo-001" \
  -d '{"model":"DOUBAO_MODEL_FROM_MODELS_PAGE","prompt":"A cinematic city at night","images":[],"metadata":{"resolution":"720p","ratio":"16:9","duration":5,"generate_audio":true,"seed":42,"watermark":false}}'

Doubao 的提示詞最多 7000 個字元，支援最多 4 個圖片 data URL 或不含認證資料的 HTTPS URL；reference_videos 支援最多 4 個 MP4/MOV data URL 或不含認證資料的 HTTPS URL，每個不超過 64 MB。時長為 4-15 秒，預設 5 秒。試驗場按模型提供 480p、720p、1080p、4k，以及 16:9、4:3、3:4、9:16、1:1、21:9、adaptive。metadata.mode 支援 t2v、i2v_first_frame、i2v_first_last_frame、multi_ref、multi_ref_vid。generate_audio 接受布林值並預設為 true；seed 不得小於 -1；watermark=true 會被拒絕。不支援的模型與分辨率組合會由報價及建立 API 拒絕。

列出 Doubao 任務：

curl "https://<LLMPOOL_HOST>/doubao/v1/video/generations?limit=20" -H "Authorization: Bearer YOUR_API_KEY"

Doubao 列表同樣支援 limit、after 及 source=api|playground，只返回 Doubao 任務；目前不支援取消任務。

curl "https://<LLMPOOL_HOST>/doubao/v1/video/generations/video_xxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

狀態包括 QUEUED、IN_PROGRESS、SUCCESS、FAILURE。結果 URL 有效期有限，過期後可重新查詢。

Doubao 擴展協議

擴展協議目前用於 H3，支援 4-15 秒、768P、16:9、9:16、1:1 及最多 4 張圖片。音訊始終由原生模型生成，請省略 metadata.generate_audio；傳入 false 會被拒絕。高階 API 調用可透過 vela 設定 generation_preset、1-16 的 generation_count、sampling 及 client_metadata。多影片結果位於 data.data.usage.results，費用按時長乘以 generation_count 計算。

阿里雲影片

阿里雲根據所選模型支援文生、首幀及參考圖影片，時長為 2-30 秒，具體時長及圖片數量限制視模型而定。metadata.generate_audio 接受布林值，省略時預設開啟。建立、查詢及列表接口分別為 POST /aliyun/v1/video_generation、GET /aliyun/v1/video_generation/{task_id} 及 GET /aliyun/v1/video_generation。目前不支援取消或刪除。

冪等、計費及錯誤

建立時建議傳入唯一 Idempotency-Key。原生 Doubao Seedance 以分辨率、比例、固定 24 FPS 及時長估算輸出 Token 預扣，完成後按上游實際 Token 多退少補；失敗或取消時全額退還。其他影片協議目前按時長預扣。餘額不足不會建立任務，非同步結算記錄可能稍後顯示。

常見錯誤包括 invalid_parameter、unsupported_parameter、model_not_found、rate_limit_exceeded、insufficient_credit 及 task_not_cancellable。GraphQL videoPriceQuote 只用於價格預估，不會建立或查詢影片任務。