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	支援文字、首幀圖、尾幀圖

說明：

支援 duration_seconds = -1，由模型自動選擇時長

計費與用量

Seedance 視頻任務採用返回 token 用量計費，而非按時長計費。預估價格 = token 單價 × token 消耗量。最終賬單使用 ReachAPI 任務響應中的 usage.output_tokens，該值由 BytePlus usage.completion_tokens 映射而來。

音頻輸出	Token 單價	說明
包含音頻	$2.40 / 100 萬 token	未傳 `generate_audio` 時默認按此檔位
不含音頻	$1.20 / 100 萬 token	傳入 `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 回呼網址，最大長度 `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
  }
}

說明：

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