seedance-2.0

Submit an async ByteDance Seedance 2.0 video generation task. Three public tiers — seedance-2.0 / seedance-2.0-fast / seedance-2.0-mini — with the mode (text / image / reference) inferred from the media inputs in the request. Returns a task_id to poll via the status endpoint until status=finished.

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

Seedance 2.0 档位。seedance-2.0 = standard（最高质量，唯一支持 1080p / 4k），-fast = 加速档，-mini = 轻量档。模式（text/image/reference）由请求中的媒体输入自动判定。

Value in"seedance-2.0" | "seedance-2.0-fast" | "seedance-2.0-mini"

prompt?string

视频描述。Text-to-Video 必填；带媒体输入（image / images / video_urls / audio_urls / image_with_roles）时可省。中文建议 ≤500 字，英文 ≤1000 词。

size?string

视频比例。adaptive 根据首帧或参考素材自动选择。

Value in"16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "adaptive"

duration?integer

视频时长，单位为秒。范围 4..15，默认 5。

Range4 <= value <= 15

image?string

首帧/参考图 URL。

images?array<string>

参考图 URL 列表。Image-to-Video: 1~~2 张（2 张时第 1 张为首帧、第 2 张为尾帧）；Reference-to-Video: 0~~9 张。与 image_with_roles 互斥。

Itemsitems <= 9

resolution?string

视频清晰度。默认 720p；1080p 和 4k 仅 seedance-2.0 支持。

Value in"480p" | "720p" | "1080p" | "4k"

generate_audio?boolean

是否生成音轨。需要明确控制音轨时请显式指定。

video_urls?array<string>

参考视频 URL（Reference-to-Video）。0~~3 个，总时长 ≤15s；格式 .mp4/.mov；480p~~720p。

Itemsitems <= 3

audio_urls?array<string>

参考音频 URL（Reference-to-Video）。0~3 个，总时长 ≤15s；格式 .wav/.mp3。必须配合图或视频输入，不能单独提供。

Itemsitems <= 3

image_with_roles?array<object>

带角色的参考图列表，与 images 互斥。

Array Item (object)

url*string

role*string

Value in"first_frame" | "last_frame" | "reference_image"

model_params?object

高级生成参数。

web_search?boolean

联网搜索，默认 false。开启后模型自主决定是否检索；触发时按搜索次数额外计费。

[key: string]?never

callback_url?string

任务终态时由平台主动 POST 的 HTTPS 回调地址（可选）

Formaturi

[key: string]?never

Response Body

application/json

curl -X POST "https://api.apimp.ai/api/generate/submit" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cat playing the Moonlight Sonata on a piano, cinematic lighting"
  }'

curl -X POST "https://api.apimp.ai/api/generate/submit" \  -H "Content-Type: application/json" \  -d '{    "model": "seedance-2.0",    "prompt": "A cat playing the Moonlight Sonata on a piano, cinematic lighting"  }'

{
  "code": 200,
  "data": {
    "task_id": "task_2BvCWmHzG6sJxK4tQpAr8M9nZyYfRdLs",
    "status": "not_started",
    "created_time": "2026-06-26T09:21:26",
    "error_message": null
  }
}

{
  "code": 400,
  "error": {
    "message": "prompt is required unless `image`, `images`, `image_with_roles`, `video_urls`, or `audio_urls` is provided",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

{
  "code": 400,
  "error": {
    "message": "string",
    "type": "invalid_request_error"
  }
}

seedance-2.0

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

429application/json

500application/json

prompt 缺失且未提供媒体输入

duration 超出 4..15

size 不在枚举内

images 超过 9 张

顶层混入 spec 未列出的字段

application/json

application/json

application/json

application/json

application/json

application/json