メインコンテンツへスキップ
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \ --url https://api.cometapi.com/volc/v3/contents/generations/tasks \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model": "doubao-seedance-1-5-pro-251215", "content": [ { "type": "text", "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9" } ] } '
{
  "id": "021773297205999example"
}
このエンドポイントを使用すると、テキスト、またはテキストと参照画像を使って ByteDance Seedance の動画タスクを開始できます。リクエストはすぐに task id を返し、レンダリングは非同期で継続されます。

現在の model パスを選択する

  • 現在利用可能な model と識別子については、Models page を参照してください。
  • このルートの現在の本番用例として doubao-seedance-1-5-pro-251215 を使用してください。
  • 同じ現在の model で、統一された content 配列を通じて、テキストのみのリクエストと画像ガイド付きリクエストの両方を処理できます。

タスクの流れ

1

content 配列を構築

最初に主要なテキスト指示を配置し、その後に最初のフレームまたは最後のフレームのガイダンスが必要な場合のみ画像項目を追加します。
2

タスクを送信

返された task id を保存します。プッシュ配信が必要な場合は、タスク作成時に callback_url を設定してください。
3

出力が届くまでポーリング

タスクが完了し、content.video_url が存在するまで ByteDance Video Query を呼び出してください。

既知のラッパー挙動

Volcengine と Seedance では、このファミリーは非同期の create-then-query ワークフローとして文書化されています。CometAPI は同じタスクパターンを維持しつつ、1 つのベース URL と 1 つの API キーを提供します。
2026-03-12 の実地検証では、このルートには到達できましたが、標準的な JSON サンプルに対して依然としてサーバー側の JSON パースエラーが返されました。ここにある OpenAPI の例を実用的なラッパー参照として扱い、開発の早い段階で payload を検証してください。

承認

Authorization
string
header
必須

Bearer token authentication. Use your CometAPI key.

ボディ

application/json
model
string
必須

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

:

"doubao-seedance-1-5-pro-251215"

content
object[]
必須

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

callback_url
string

Optional webhook URL for task status notifications.

レスポンス

200 - application/json

Task accepted.

id
string
必須

Task id for later polling.