動画 API

LLMPool は MiniMax、Doubao、Doubao 拡張プロトコル、Alibaba Cloud 動画モデルを提供します。Alibaba のルートは /aliyun/v1 です。

認証

Board で作成したアカウント API キーを使用します。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

以下の https://<LLMPOOL_HOST> はサービスのルート URL です。動画 API は /openai/v1 を使用しません。model には Models ページに表示される 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 に対応します。画像モードでは role: "first_frame" の image_url を 1 件指定し、比率は 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 のプロンプトは最大 7,000 文字です。画像 data URL または認証情報を含まない HTTPS URL を最大 4 件指定でき、reference_videos には MP4/MOV の data URL または認証情報を含まない HTTPS URL を最大 4 件（各 64 MB）指定できます。長さは 4-15 秒、既定値は 5 秒です。Playground ではモデルに応じて 480p、720p、1080p、4k と 16:9、4:3、3:4、9:16、1:1、21:9、adaptive を選択できます。generate_audio は真偽値を受け付け、既定値は true です。metadata.mode は t2v、i2v_first_frame、i2v_first_last_frame、multi_ref、multi_ref_vid に対応します。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 のタスク取消 API は現在ありません。

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 です。

Alibaba Cloud 動画

Alibaba は選択したモデルに応じて、テキスト、先頭フレーム、参照画像からの動画生成に対応します。長さは 2-30 秒で、正確な範囲と画像数はモデルによって異なります。metadata.generate_audio は真偽値を受け付け、未指定時は true です。作成、照会、一覧はそれぞれ POST /aliyun/v1/video_generation、GET /aliyun/v1/video_generation/{task_id}、GET /aliyun/v1/video_generation を使用します。取消、削除には現在対応していません。

冪等性、課金、エラー

作成時は一意の Idempotency-Key を送信してください。ネイティブ Doubao Seedance は解像度、比率、固定 24 FPS、長さから出力トークンを見積もって事前請求し、完了後に上流の実使用トークンとの差額を返金または追加請求します。失敗または取消時は全額返金されます。他の動画プロトコルは現在、長さで事前請求します。残高不足ではタスクは作成されません。

主なエラーは invalid_parameter、unsupported_parameter、model_not_found、rate_limit_exceeded、insufficient_credit、task_not_cancellable です。GraphQL videoPriceQuote は料金見積もり専用で、動画タスクの作成や照会は行いません。