Seedance 1.5 API

ReachAPI は公開モデル ID seedance-1-5-pro を通じて Seedance 1.5 を提供します。

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

重要事項:

作成: POST /v1/vids/create
照会: GET /v1/tasks/{task_id}
モデル ID: seedance-1-5-pro
実行方式: 非同期タスク
すべてのリクエストで明示的な 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-1-5-pro`	`4-12s`	`480p`, `720p`, `1080p`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`	Required	テキスト、先頭フレーム画像、末尾フレーム画像をサポート

Notes:

duration_seconds = -1 を指定するとモデルが長さを自動選択します

課金と使用量

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

音声出力	トークン単価	注記
音声あり	$2.40 / 100万トークン	`generate_audio` 未指定時のデフォルト階層
音声なし	$1.20 / 100万トークン	`generate_audio=false` の場合に適用

4. Create Task

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

4.1 Top-Level Parameters

Field	Type	Required	Description
`model`	string	Yes	`seedance-1-5-pro`
`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-12` または `-1`
`resolution`	string	Yes	`480p`, `720p`, `1080p`
`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 文字列

5. `input.content` Structure

Supported type:

text
image_url

Supported role:

first_frame
last_frame

Field	Type	Required	Description
`content[].type`	string	Yes	`text` または `image_url`
`content[].text`	string	Required for `type = text`	テキスト内容
`content[].role`	string	Conditionally required	`first_frame` または `last_frame`
`content[].image_url.url`	string	Required for `type = image_url`	画像 URL、Base64 画像、またはアップロード済み素材 ID

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-1-5-pro",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A luxury watch slowly rotates on a marble pedestal under soft studio light"
      }
    ],
    "duration_seconds": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}

7.2 First-Frame and Last-Frame Guided Video

{
  "model": "seedance-1-5-pro",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "The character slowly turns toward the camera and smiles"
      },
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://cdn.example.com/first-frame.png"
        }
      },
      {
        "type": "image_url",
        "role": "last_frame",
        "image_url": {
          "url": "https://cdn.example.com/last-frame.png"
        }
      }
    ],
    "duration_seconds": 5,
    "resolution": "1080p",
    "aspect_ratio": "9:16"
  }
}

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-12
aspect_ratio は adaptive をサポート

Seedance 1.5 API

On this page