Seedance 2.5 API

ReachAPI は公開モデル ID seedance-2-5 と統一された非同期動画タスク API を通じて ByteDance Seedance 2.5 を提供します。

タスク作成: POST /v1/vids/create
タスク照会: GET /v1/tasks/{task_id}
実行方式: 非同期。タスク API をポーリングするか callback_url を指定
モデル ID: seedance-2-5

認証

Authorization: Bearer YOUR_REACH_API_KEY
Content-Type: application/json

機能と価格

長さ	解像度	アスペクト比	入力モード
`4`〜`30` の整数、または `-1` で自動選択	`480p`、`720p`	`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`adaptive`	テキスト、画像、動画、音声、音声のみ

input.content は必須で、空でない配列である必要があります。prompt、image_url、video_urls などの旧項目は自動変換されません。

動画入力	価格
`input.content` に `video_url` なし	$10.70 / 100万出力トークン
`input.content` に `video_url` あり	$6.40 / 100万出力トークン

動画時間ではなく、返却された出力トークンで課金されます。ReachAPI は BytePlus の usage.completion_tokens を usage.output_tokens にマッピングし、成功したタスクをその値で精算します。

タスクを作成

{
  "model": "seedance-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A cinematic train journey through a mountain valley at sunrise"
      }
    ],
    "duration_seconds": 12,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

トップレベル項目

項目	型	必須	説明
`model`	string	はい	`seedance-2-5` 固定
`callback_url`	string	いいえ	終了状態を受け取る HTTPS URL。最大 2048 文字。プライベートネットワークは禁止
`input`	object	はい	動画生成パラメーター

`input` 項目

項目	型	必須	説明
`content`	object array	はい	空でない明示的なマルチモーダル入力
`resolution`	string	はい	`480p` または `720p`
`duration_seconds`	integer	いいえ	`4`〜`30`、または `-1` で長さを自動選択
`aspect_ratio`	string	条件付き	対応比率のいずれか。先頭・末尾フレーム生成では `adaptive` が必須
`generate_audio`	boolean	いいえ	音声生成を要求
`watermark`	boolean	いいえ	ウォーターマーク設定をモデルへ渡す
`return_last_frame`	boolean	いいえ	最終フレーム画像を要求
`output_format`	string	いいえ	`mp4` または `mov`
`priority`	integer	いいえ	`0`〜`9` のスケジューリング優先度
`safety_identifier`	string	いいえ	最大 64 文字の ASCII エンドユーザー安全識別子

Seedance 2.5 は seed、edit_mode、extend_mode に対応しません。編集と延長は、参照コンテンツとテキストプロンプトで表現します。

`input.content`

タイプ	Role	上限	説明
`text`	なし	1	プロンプトまたは編集指示
`image_url`	`first_frame`	1	先頭フレーム。role なしの画像も先頭フレーム扱い
`image_url`	`last_frame`	1	末尾フレーム。先頭フレームも必要
`image_url`	`reference_image`	画像合計 30	被写体、シーン、スタイル参照
`video_url`	`reference_video`	10	動作、編集、延長の参照
`audio_url`	`reference_audio`	10	音声参照。音声のみの入力にも対応

URL は image_url.url、video_url.url、audio_url.url に配置します。クライアント素材は公開アクセス可能な https:// URL に限られます。HTTP、Base64、data: URL、裸の Base64、クライアントが送信する asset:// は拒否されます。

先頭・末尾フレームと reference_image、reference_video、reference_audio は併用できません。末尾フレームには先頭フレームも必要で、先頭・末尾フレームのリクエストでは aspect_ratio=adaptive を明示する必要があります。

リクエスト例

音声のみの入力と MOV 出力

{
  "model": "seedance-2-5",
  "input": {
    "content": [
      {
        "type": "audio_url",
        "role": "reference_audio",
        "audio_url": { "url": "https://cdn.example.com/music.mp3" }
      }
    ],
    "duration_seconds": 20,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "generate_audio": true,
    "output_format": "mov",
    "priority": 5
  }
}

参照動画の編集または延長

{
  "model": "seedance-2-5",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "Continue this scene into a rainy night and preserve the camera movement"
      },
      {
        "type": "video_url",
        "role": "reference_video",
        "video_url": { "url": "https://cdn.example.com/source.mp4" }
      }
    ],
    "duration_seconds": 10,
    "resolution": "480p",
    "aspect_ratio": "16:9"
  }
}

edit_mode や extend_mode は追加しません。操作はコンテンツとプロンプトで定義します。

レスポンス、ポーリング、コールバック

送信レスポンス:

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

status が success または failed になるまで GET /v1/tasks/task_xxx をポーリングします。

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

成功した動画結果には data[].url が含まれます。callback_url を指定すると、ReachAPI は同じ終了レスポンス構造を POST で送信します。

BytePlus は人物やプライバシー肖像の参照素材を Asset Library に保存するよう要求する場合があります。最初の送信でこの種類のエラーが返された場合、ReachAPI は元の HTTPS 素材を現在の provider の Asset Library にアップロードし、内部で書き換えて 1 回再試行します。クライアントは引き続き元の HTTPS URL を送信し、asset:// は送信しません。

制約とエラー

input.content と resolution は必須
長さは 4-30 または -1。1080p は非対応
テキスト 1 件、画像 30 枚、動画 10 本、音声 10 本まで
video_url には reference_video、audio_url には reference_audio が必須
未知の項目、非対応の旧項目、無効な素材 URL は 400
401 は API Key 無効、402 は残高不足、422 は安全性による拒否、429 はレート制限