タスク作成（Volc 互換）

​

概要

​

コンテンツ規則

• プロンプト文には type=text を使います。
• role なしの type=image_url は最初のフレームとして扱われます。明示的に role=first_frame を指定することもできます。
• role=last_frame は最初のフレームと一緒にのみ使用できます。
• 参照メディアには role=reference_image、reference_video、reference_audio を使います。
• 1 つのリクエストで首尾フレーム入力と参照メディアを混在させないでください。

​

パラメータ補足

• ratio は 16:9、4:3、1:1、3:4、9:16、21:9、adaptive を受け付けます。
• generate_audio の公式既定値は false です。同期音声が必要な場合は true を指定します。
• service_tier=default は受け付けます。Seedance 2.0 互換タスクでは service_tier=flex、frames、camera_fixed=true は拒否されます。
• 選択したモデルが対応している場合、tools には { "type": "web_search" } のようなオブジェクトを渡せます。不正な tool 項目は無視せず拒否します。

​

例

curl https://api.tokenlab.sh/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Idempotency-Key: $CLIENT_JOB_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      {"type": "text", "text": "A cinematic forest at sunset"},
      {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/ref.png"}}
    ],
    "ratio": "16:9",
    "duration": 5,
    "resolution": "720p",
    "generate_audio": false
  }'