影片 API

LLMPool 為 MiniMax 和 Doubao 提供兩套不同的非同步影片協議。兩者的路徑及請求參數不同，不能混用。

認證

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

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

以下以 https://<LLMPOOL_HOST> 表示服務根地址。影片 API 不使用 /openai/v1 路徑，model 應填寫 模型廣場顯示的模型 ID。建立成功後，每 5-10 秒查詢一次任務，直至成功或失敗。

協議能力

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":false,"seed":42,"watermark":false}}'

Doubao 的提示詞最多 7000 個字元，支援最多 4 個圖片 data URL 或不含認證資料的 HTTPS URL，時長為 1-60 秒。試驗場提供 480p、720p、1080p 及 16:9、4:3、1:1。generate_audio 必須為 false 或省略。

列出 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 有效期有限，過期後可重新查詢。

冪等、計費及錯誤

建立時建議傳入唯一 Idempotency-Key。平台按模型、時長、分辨率及價格規則預扣餘額；餘額不足不會建立任務。失敗或取消後由非同步結算處理退款。

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