Seedance 2 Fast

POST https://api.beatapi.io/v1/videos/tasks

通过 Seedance 2.0 快速通道生成 4–15 秒的 480p 或 720p 视频，可选择同时生成音频。

支持的生成方式

异步任务流程

创建任务后保存 data.id，每 5–10 秒调用 GET /v1/tasks/{task_id} 查询状态。status 为 succeeded 时读取 data.output.media，为 failed 时读取 data.error_code 和 data.error_message，随后按错误与重试策略处理。

使用本地文件

请先上传本地输入，再将返回的 data.url 填入请求。

鉴权

Authorization   string   必填

在 Authorization 请求头中以 Bearer 令牌发送服务端 API 密钥，可在控制台创建。

Authorization: Bearer <BEATAPI_API_KEY>

永久 API 密钥只能保存在可信服务端，不能写入浏览器、移动端、公开脚本、日志或截图。请求体必须使用 Content-Type: application/json。建议为每个逻辑创建请求设置唯一的 Idempotency-Key，只有完全相同的请求体才能安全复用原键。

请求体

字段名、类型和枚举值保留英文原样，用途和限制用中文说明。

model   string   必填

稳定的公开模型 ID，必须使用当前页面列出的值。

取值与默认值: 固定值 seedance-2-fast

prompt   string   必填

描述生成、编辑或分析目标的提示词。

取值与默认值: 长度 1–5000 字符

images   string[]   选填

按当前模型或工作流要求排序的公网 HTTPS 图片 URL 列表。

取值与默认值: 1–2 项

reference_images   string[]   选填

多模态或参考图生成使用的公网 HTTPS 图片 URL 列表。

取值与默认值: 1–9 项

reference_videos   string[]   选填

多模态或动作迁移使用的公网 HTTPS 视频 URL 列表。

取值与默认值: 1–3 项

reference_audios   string[]   选填

多模态生成使用的公网 HTTPS 参考音频 URL 列表。

取值与默认值: 1–3 项

duration   integer   选填

请求的输出时长，单位为秒。

取值与默认值: 默认值 5；取值范围 4–15

aspect_ratio   enum<string>   选填

输出素材的宽高比。

取值与默认值: 可选值 adaptive、21:9、16:9、4:3、1:1、3:4、9:16；默认值 adaptive

resolution   enum<string>   选填

输出素材的分辨率或质量档位。

取值与默认值: 可选值 480p、720p；默认值 720p

generate_audio   boolean   选填

是否在生成视频时同时生成同步音频。

取值与默认值: 默认值 true

请求示例

文生视频

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2-fast",
>
  "prompt": "A fast handheld tracking shot through a crowded neon night market.",
>
  "duration": 5,
>
  "aspect_ratio": "16:9",
>
  "resolution": "720p",
>
  "generate_audio": true
>
}'

首帧驱动

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2-fast",
>
  "prompt": "Animate the performer with a quick natural camera push-in.",
>
  "images": [
>
    "https://media.beatapi.io/samples/neon-singer.png"
>
  ],
>
  "duration": 5,
>
  "resolution": "720p",
>
  "generate_audio": true
>
}'

多模态参考

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2-fast",
>
  "prompt": "Create a synchronized draft from the supplied image and audio references.",
>
  "reference_images": [
>
    "https://media.beatapi.io/samples/neon-singer.png"
>
  ],
>
  "reference_audios": [
>
    "https://media.beatapi.io/samples/neon-singer-preview.mp3"
>
  ],
>
  "duration": 5,
>
  "resolution": "720p",
>
  "generate_audio": true
>
}'

响应

成功请求返回 HTTP 201，响应体如下。

1
{
2
  "data": {
3
    "id": "task_8K2qA",
4
    "object": "task",
5
    "task_kind": "video",
6
    "capability_id": "seedance-2-fast",
7
    "capability_version": null,
8
    "media_type": "video",
9
    "model": "seedance-2-fast",
10
    "status": "queued",
11
    "stage": "queued",
12
    "created_at": 1782210000,
13
    "updated_at": 1782210000,
14
    "completed_at": null,
15
    "output": null,
16
    "usage": {
17
      "credits_reserved": 0.7,
18
      "credits_charged": 0.7,
19
      "billable_duration_seconds": 5,
20
      "credits_settled": 0,
21
      "credits_refunded": 0
22
    },
23
    "request_id": "req_abc123",
24
    "error_code": null,
25
    "error_message": null
26
  }
27
}

下一步

保存接受响应中的 data.id，每 5–10 秒轮询 GET /v1/tasks/{task_id}。任务成功后从 data.output.media 读取托管结果。

错误