Seedance 2 API

ReachAPI は公開モデル ID seedance-2 と seedance-2-fast を通じて Seedance 2 系列を提供します。

このページでは、ReachAPI で Seedance 2 モデルを呼び出すためのリクエスト項目、制約、サンプルを説明します。

重要事項:

作成: POST /v1/vids/create
照会: GET /v1/tasks/{task_id}
モデル ID: seedance-2, seedance-2-fast
実行方式: 非同期タスク
すべてのリクエストで明示的な input.content が必要です

1. API Overview

HTTP method: POST
Request path: /v1/vids/create
Content-Type: application/json
Result delivery:
- 送信時はタスク受付情報を返します
- 最終結果は /v1/tasks/{task_id} のポーリングまたは callback_url で取得します

2. Authentication and Headers

Authorization: Bearer YOUR_REACH_API_KEY
Content-Type: application/json

3. Model Capability Summary

Model	Duration	Resolution	Aspect ratio	`input.content`	Notes
`seedance-2`	`4-15s`	`480p`, `720p`, `1080p`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`	Required	テキスト、画像、動画、音声参照、編集、続き生成をサポート
`seedance-2-fast`	`4-15s`	`480p`, `720p`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`	Required	`seedance-2` と同じ項目をサポート、ただし `1080p` は非対応

課金と使用量

Seedance の動画タスクは、再生時間ではなく返却されたトークン使用量を基準に課金されます。推定価格 = トークン単価 × トークン消費量。最終課金は ReachAPI のタスクレスポンスに含まれる usage.output_tokens を使用します。この値は BytePlus の usage.completion_tokens からマッピングされます。

モデル	動画入力	解像度	トークン単価
`seedance-2`	なし	480p / 720p	$7.00 / 100万トークン
`seedance-2`	なし	1080p	$7.70 / 100万トークン
`seedance-2`	あり	480p / 720p	$4.30 / 100万トークン
`seedance-2`	あり	1080p	$4.70 / 100万トークン
`seedance-2-fast`	なし	480p / 720p	$5.60 / 100万トークン
`seedance-2-fast`	あり	480p / 720p	$3.30 / 100万トークン
`seedance-2-fast`	任意	1080p	非対応

4. Create Task

{
  "model": "seedance-2",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A cinematic drone shot passing over a coastline at sunrise"
      }
    ],
    "duration_seconds": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}

4.1 Top-Level Parameters

Field	Type	Required	Description
`model`	string	Yes	`seedance-2` または `seedance-2-fast`
`callback_url`	string	No	タスク終端状態の HTTPS コールバック URL。最大長 `2048`
`input`	object	Yes	動画生成パラメータ

4.2 `input` Parameters

Field	Type	Required	Description
`content`	`array<object>`	Yes	明示的なマルチモーダル入力。空配列は不可
`duration_seconds`	integer	No	`4-15` または `-1`
`resolution`	string	Yes	`seedance-2`: `480p`, `720p`, `1080p`; `seedance-2-fast`: `480p`, `720p`
`aspect_ratio`	string	No	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`
`generate_audio`	boolean	No	音声生成を要求
`seed`	integer	No	ランダムシード。範囲は `-1` から `4294967295`。`-1` はランダム
`safety_identifier`	string	No	エンドユーザー向け安全識別子。64 文字以内の ASCII 文字列
`watermark`	boolean	No	ウォーターマーク設定
`return_last_frame`	boolean	No	最終フレーム画像の返却を要求
`edit_mode`	string	No	対応シナリオでの編集動作を制御
`extend_mode`	string	No	対応シナリオでの続き生成動作を制御

5. `input.content` Structure

Supported type:

text
image_url
video_url
audio_url

Supported role:

first_frame
last_frame
reference_image
reference_video
reference_audio

Field	Type	Required	Description
`content[].type`	string	Yes	`text`, `image_url`, `video_url`, `audio_url`
`content[].role`	string	No	非テキスト項目は通常明示指定を推奨
`content[].text`	string	Required for `type = text`	テキスト内容
`content[].image_url.url`	string	Required for `type = image_url`	画像 URL またはアップロード済み素材 ID
`content[].video_url.url`	string	Required for `type = video_url`	動画 URL またはアップロード済み素材 ID
`content[].audio_url.url`	string	Required for `type = audio_url`	音声 URL またはアップロード済み素材 ID

主な制約:

content は 1 要素以上必要
画像は最大 9 件
動画は最大 3 件
音声は最大 3 件
text と audio を併用する場合は、少なくとも 1 つの reference_image または reference_video が必要
音声のみ、または text + audio のみは非対応

6. Legacy Fields No Longer Supported

以下の旧フィールドは 400 を返します:

input.prompt
input.image_url
input.image_urls
input.last_image_url
input.video_urls
input.audio_urls
input.negative_prompt
input.parameters
input.instances
input.service_tier
input.execution_expires_after
input.frames
input.camera_fixed
input.draft
input.content[].draft_task

7. Request Examples

7.1 Text-to-Video

{
  "model": "seedance-2",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A stylized travel film scene with dynamic camera movement"
      }
    ],
    "duration_seconds": 8,
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}

7.2 Multimodal Reference Input

{
  "model": "seedance-2",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A stylized travel film scene with dynamic camera movement"
      },
      {
        "type": "image_url",
        "role": "reference_image",
        "image_url": {
          "url": "https://cdn.example.com/scene-start.png"
        }
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://cdn.example.com/reference-motion.mp4"
        }
      }
    ],
    "duration_seconds": 8,
    "resolution": "1080p",
    "aspect_ratio": "adaptive"
  }
}

7.3 Reference Video Extension

{
  "model": "seedance-2-fast",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "Extend this clip into a faster action sequence"
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": {
          "url": "https://cdn.example.com/reference-1.mp4"
        }
      }
    ],
    "duration_seconds": 6,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "extend_mode": "continue"
  }
}

8. Create Task Response

{
  "code": 200,
  "msg": "",
  "status": "queued",
  "task_id": "task_xxx",
  "data": []
}

9. Query Task Status

{
  "code": 200,
  "msg": "",
  "status": "success",
  "task_id": "task_xxx",
  "data": [
    {
      "url": "https://cdn.example.com/generated/video-1.mp4"
    }
  ],
  "usage": {
    "input_tokens": 0,
    "output_tokens": 102960,
    "total_tokens": 102960
  }
}

Notes:

data には動画結果の配列が入ります
ReachAPI は成功した動画出力に対して少なくとも data[].url を返します

10. Callback Delivery

callback_url を指定した場合、タスクが終端状態になると同じ JSON 構造で POST 配信されます。

11. Constraints and Notes

input.content は必須
resolution は必須
duration_seconds は -1 または 4-15
seedance-2-fast は 1080p 非対応

Seedance 2 API

On this page