動画 API

LLMPool は MiniMax と Doubao 向けに別々の非同期動画プロトコルを提供します。パスとリクエスト形式は異なるため、混在させないでください。

認証

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

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

以下の https://<LLMPOOL_HOST> はサービスのルート URL です。動画 API は /openai/v1 を使用しません。model には Models ページに表示される 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 に対応します。画像モードでは 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":false,"seed":42,"watermark":false}}'

Doubao のプロンプトは最大 7,000 文字です。画像 data URL または認証情報を含まない HTTPS URL を最大 4 件指定でき、長さは 1-60 秒です。Playground では 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 のタスク取消 API は現在ありません。

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 は料金見積もり専用で、動画タスクの作成や照会は行いません。