Seedance 1 API

ReachAPI 目前透過公開模型 ID seedance-1-0-pro 與 seedance-1-0-pro-fast 對外提供 Seedance 1 系列能力。

本文說明如何在 ReachAPI 中呼叫 Seedance 1 模型，包括請求參數、限制與範例。

重要說明：

提交任務：POST /v1/vids/create
查詢任務：GET /v1/tasks/{task_id}
模型 ID：seedance-1-0-pro、seedance-1-0-pro-fast
執行方式：非同步任務
所有請求現在都必須明確傳入 input.content
ReachAPI 不再根據舊的 prompt、image_url 等便捷欄位自動組裝 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-0-pro`	`2-12s`	`480p`, `720p`, `1080p`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`	Required	支援文字、首幀圖、尾幀圖
`seedance-1-0-pro-fast`	`2-12s`	`480p`, `720p`, `1080p`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`	Required	支援文字與首幀圖；不支援尾幀圖

計費與用量

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

模型	Token 單價	說明
`seedance-1-0-pro`	$2.50 / 100 萬 token	僅成功生成視頻時計費
`seedance-1-0-pro-fast`	$1.00 / 100 萬 token	僅成功生成視頻時計費

4. Create Task

{
  "model": "seedance-1-0-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-0-pro` 或 `seedance-1-0-pro-fast`
`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	輸出時長，範圍 `2-12`
`resolution`	string	Yes	`480p`, `720p`, `1080p`
`aspect_ratio`	string	No	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`

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

限制：

content 至少需要 1 個元素
text 最多 1 個
image_url 最多 2 個
first_frame 最多 1 個
last_frame 最多 1 個
使用 last_frame 時必須同時提供 first_frame
seedance-1-0-pro-fast 不支援 last_frame

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.safety_identifier
input.seed
input.frames
input.camera_fixed
input.draft
input.content[].draft_task

7. Request Examples

7.1 Text-to-Video

{
  "model": "seedance-1-0-pro",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A paper boat floating through a neon-lit rainy street at night"
      }
    ],
    "duration_seconds": 4,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }
}

7.2 First-Frame Image-to-Video

{
  "model": "seedance-1-0-pro-fast",
  "input": {
    "content": [
      {
        "type": "text",
        "text": "A product shot transitions into a dramatic rotating hero reveal"
      },
      {
        "type": "image_url",
        "role": "first_frame",
        "image_url": {
          "url": "https://cdn.example.com/product.png"
        }
      }
    ],
    "duration_seconds": 3,
    "resolution": "720p",
    "aspect_ratio": "1:1"
  }
}

7.3 First-Frame and Last-Frame Guided Video

{
  "model": "seedance-1-0-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 必須位於 2-12
seedance-1-0-pro-fast 不支援 last_frame

Seedance 1 API

On this page