seedance-2.5

Seedance 2.5 的五种视频能力共用一个创建端点。请切换到对应能力查看请求格式，再使用创建响应返回的任务 ID 查询结果。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "callback_url": "https://example.com/webhooks/seedance",
    "content": [
      {
        "type": "text",
        "text": "一段 20 秒的电影级跟拍镜头，穿过夕阳下的微缩蒸汽朋克城市"
      }
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 20,
    "output_format": "mp4"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

AnyFast 模型 ID。使用 seedance-2.5。对于特定内容请求，请选择 Direct 资源组并使用 seedance-2.5-nsfw。

object[]

必填

输入内容。文生视频至少需要一个文本项。

string

必填

提示词项使用 text。

string

必填

描述主体、动作、场景、视觉风格、运镜和声音意图的提示词。

boolean

默认值:true

生成同步对白、音效和背景音频。

string

默认值:"720p"

输出分辨率。可选值：480p、720p、1080p。1080p 使用 10bit H.265/HEVC 输出。

string

默认值:"adaptive"

输出宽高比。可选值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive。

integer

默认值:-1

输出时长。使用 -1 自动选择，或填写 4–30 的整数。

object[]

可选文生视频工具。将 tools[].type 设为 web_search，可在生成前搜索时效信息。

创建响应

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

查询结果所用的任务 ID。

string

任务 ID，与 id 相同。

string

返回对象类型，本接口固定为 video。

string

任务使用的 AnyFast 模型 ID。

string

初始任务状态，新接受的任务为 queued。

integer

初始任务进度百分比。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"让 @image1 执行 @video1 的动作，并跟随 @audio1 的节奏"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 15,
    "output_format": "mp4"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

可选值：seedance-2.5、seedance-2.5-nsfw。

string

参考任务类型。可选值：auto、reference、edit、extend。本能力使用 reference；使用 auto 时由模型根据素材和提示词判断工作流。

object[]

必填

文本与参考素材。提示词可省略。使用 @image1、@video1、@audio1 按类型和顺序引用素材。最多支持 30 张图片、10 个视频和 10 段音频。

string

必填

内容类型：text、image_url、video_url 或 audio_url。

string

text 项的提示词。

string

公开图片 URL、Base64 data URI 或 asset://<ASSET_ID>。

string

公开视频 URL 或 asset://<ASSET_ID>。

string

公开音频 URL、Base64 data URI 或 asset://<ASSET_ID>。

string

必填

素材角色：reference_image、reference_video 或 reference_audio。

boolean

默认值:true

生成同步音频。

string

默认值:"720p"

可选值：480p、720p、1080p。

string

默认值:"adaptive"

可选值：21:9、16:9、4:3、1:1、3:4、9:16、adaptive。

integer

默认值:-1

使用 -1 或填写 4–30 的整数。

创建响应

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

查询结果所用的任务 ID。

string

任务 ID，与 id 相同。

string

返回对象类型。

string

AnyFast 模型 ID。

string

初始任务状态。

integer

初始任务进度百分比。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"编辑 @video1：移除所有背景行人，同时保留主体"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": -1,
    "output_format": "mov"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

可选值：seedance-2.5、seedance-2.5-nsfw。

string

参考任务类型。视频编辑使用 edit。可选值：auto、reference、edit、extend。

object[]

必填

编辑指令和源素材。

string

必填

指令使用 text，源视频使用 video_url。

string

必填

编辑指令，使用 @video1 引用源视频。

string

必填

公开源视频 URL 或 asset://<ASSET_ID>。

string

必填

源视频使用 reference_video。

boolean

默认值:true

生成同步音频。

string

默认值:"720p"

可选值：480p、720p、1080p。

string

默认值:"adaptive"

必填

视频编辑仅支持 adaptive，输出跟随源视频宽高比。

integer

默认值:-1

必填

视频编辑仅支持 -1，输出时长接近源视频，可能最多短 0.4 秒。

创建响应

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

查询结果所用的任务 ID。

string

任务 ID，与 id 相同。

string

返回对象类型。

string

AnyFast 模型 ID。

string

初始任务状态。

integer

初始任务进度百分比。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "extend",
    "content": [
      {"type":"text","text":"延长 @video1：镜头穿过打开的窗户，进入一间安静的画廊"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 11,
    "output_format": "mov"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

可选值：seedance-2.5、seedance-2.5-nsfw。

string

参考任务类型。视频延长使用 extend。可选值：auto、reference、edit、extend。

object[]

必填

延长指令和参考素材。

string

必填

指令使用 text，视频素材使用 video_url。

string

必填

延长指令，使用 @video1 指定要延长的视频。

string

必填

公开视频 URL 或 asset://<ASSET_ID>。

string

必填

视频素材使用 reference_video。

boolean

默认值:true

生成同步音频。

string

默认值:"720p"

可选值：480p、720p、1080p。

string

默认值:"adaptive"

必填

视频延长仅支持 adaptive，输出跟随所选源视频宽高比。

integer

默认值:-1

使用 -1 或填写 4–30 的整数；指定整数时长时必须长于源视频。

创建响应

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

查询结果所用的任务 ID。

string

任务 ID，与 id 相同。

string

返回对象类型。

string

AnyFast 模型 ID。

string

初始任务状态。

integer

初始任务进度百分比。

integer

创建时间，Unix 秒级时间戳。

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.ai/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "content": [
      {"type":"text","text":"主体对着镜头微笑，同时镜头平滑环绕一周"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "generate_audio": true,
    "resolution": "1080p",
    "ratio": "adaptive",
    "duration": 5,
    "output_format": "mp4"
  }'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

默认值:"application/json"

必填

数据交换格式。

请求体

string

必填

可选值：seedance-2.5、seedance-2.5-nsfw。

object[]

必填

提示词和一张首帧图片，可再提供一张尾帧图片。

string

必填

提示词使用 text，帧图片使用 image_url。

string

描述运动和帧间过渡的提示词。

string

必填

公开图片 URL、Base64 data URI 或 asset://<ASSET_ID>。

string

必填

首图使用 first_frame，可选的第二张图使用 last_frame。

boolean

默认值:true

生成同步音频。

string

默认值:"720p"

可选值：480p、720p、1080p。

string

默认值:"adaptive"

必填

首帧或首尾帧生视频仅支持 adaptive，输出跟随首帧宽高比。

integer

默认值:-1

使用 -1 或填写 4–30 的整数。

创建响应

200

{
  "id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
  "object": "video",
  "model": "seedance-2.5",
  "status": "queued",
  "progress": 0,
  "created_at": 1786084139
}

string

查询结果所用的任务 ID。

string

任务 ID，与 id 相同。

string

返回对象类型。

string

AnyFast 模型 ID。

string

初始任务状态。

integer

初始任务进度百分比。

integer

创建时间，Unix 秒级时间戳。

按 ID 查询任务

GET /v1/video/generations/{id}

cURL

curl --request GET \
  --url https://www.anyfast.ai/v1/video/generations/asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM \
  --header 'Authorization: Bearer YOUR_API_KEY'

请求头

string

必填

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

路径参数

string

必填

创建请求返回的任务 ID。

任务结果字段

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_qBzoyYsNfDYLAsXFzmmHscK5Y7OGjtpM",
    "action": "omniGenerate",
    "status": "SUCCESS",
    "result_url": "https://example.com/generated-video.mp4",
    "submit_time": 1786084139,
    "start_time": 1786084145,
    "finish_time": 1786084265,
    "progress": "100%",
    "request_id": "20260807143000000000000example",
    "data": {
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      },
      "duration": 20,
      "generate_audio": true,
      "ratio": "16:9",
      "resolution": "1080p",
      "output_format": "mp4",
      "status": "succeeded"
    }
  }
}

string

响应状态码。

string

响应消息。

string

平台任务 ID。

string

生成动作，例如 generate、referenceGenerate 或 omniGenerate。

string

NOT_START、QUEUED 或 IN_PROGRESS 时继续轮询；SUCCESS 时读取 result_url；FAILURE 时读取 fail_reason。

string

生成视频 URL，有效期 24 小时，最多下载 100 次。

string

status 为 FAILURE 时的失败原因。

integer

任务提交 Unix 秒级时间戳。

integer

任务开始 Unix 秒级时间戳。

integer

任务完成 Unix 秒级时间戳。

string

任务进度百分比。

string

请求溯源 ID。

object

供应商结果元数据。

string

供应商结果中的生成视频 URL。

number

生成视频时长（秒）。

boolean

结果是否包含生成音频。

string

生成视频宽高比。

string

生成视频分辨率。

string

生成视频的容器格式：mp4 或 mov。

string

供应商任务状态。

公共可选控制参数

以下字段适用于所有创建能力。

string

任务进入 SUCCESS 或 FAILURE 时，AnyFast 会向该公网 HTTP(S) 地址发送 POST 回调。回调体与 GET /v1/video/generations/{id} 返回的任务结果一致。

回调请求体示例

成功
失败

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_success",
    "action": "textGenerate",
    "status": "SUCCESS",
    "result_url": "https://example.com/generated-video.mp4",
    "submit_time": 1789573802,
    "start_time": 1789573812,
    "finish_time": 1789573951,
    "progress": "100%",
    "request_id": "20260916155001example",
    "data": {
      "id": "cgt-20260916235002-example",
      "model": "doubao-seedance-2-5-260628",
      "status": "succeeded",
      "content": {
        "video_url": "https://example.com/generated-video.mp4"
      },
      "duration": 4,
      "resolution": "480p",
      "ratio": "16:9",
      "generate_audio": true,
      "output_format": "mp4"
    }
  }
}

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_failure",
    "action": "textGenerate",
    "status": "FAILURE",
    "fail_reason": "task failed",
    "submit_time": 1789574546,
    "start_time": 1789574551,
    "finish_time": 1789574663,
    "progress": "100%",
    "request_id": "20260916160226example",
    "data": {
      "id": "cgt-20260917000226-example",
      "model": "doubao-seedance-2-5-260628",
      "status": "failed",
      "error": {
        "code": "OutputVideoSensitiveContentDetected.PolicyViolation",
        "message": "The output video may be related to copyright restrictions."
      }
    }
  }
}

integer

默认值:172800

任务排队或运行的最长时间（秒），超时后任务过期。

integer

默认值:0

任务执行优先级。

string

用于安全追踪的稳定终端用户标识。

integer

默认值:-1

随机种子，使用 -1 随机选择。

string

默认值:"default"

任务服务等级。

string

默认值:"mp4"

输出视频容器格式。可选值：mp4、mov。字段名必须使用 output_format；不支持 out_format，传错时可能被忽略。

boolean

默认值:false

在右下角添加“AI 生成”水印。

boolean

默认值:false

以图片形式返回生成视频的最后一帧。

输入限制

图片

传入方式：公开 URL、Base64 data URI 或素材 ID。
格式：JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF。
宽高比 0.4–2.5；宽高各 300–6,000 px；单张图片小于 30 MB。
首帧生视频传 1 张，首尾帧生视频传 2 张，全模态参考生视频传 1–30 张。

视频

传入方式：公开 URL 或素材 ID。容器：MP4、MOV。视频编码：H.264/AVC、H.265/HEVC。音频编码：AAC、MP3；MOV 还支持 PCM。
输入分辨率：480p、720p；帧率：24–60 FPS；宽高比：0.4–2.5；宽高各 300–6,000 px；单帧总像素：407,696–8,295,044；单个文件不超过 200 MB。
非视频编辑任务中，单个视频时长 2–30 秒；视频编辑任务中为 4–30 秒。最多传入 10 个参考视频，总时长不超过 30 秒。

音频

传入方式：公开 URL、Base64 data URI 或素材 ID。格式：WAV、MP3。
单段时长 2–30 秒，单个文件不超过 15 MB。最多传入 10 段，总时长不超过 30 秒。

完整请求体不得超过 64 MB，大文件请勿使用 Base64。任务记录保存 7 天；生成视频 URL 保存 24 小时，最多下载 100 次。

资料来源：Seedance 2.5 教程和创建视频生成任务 API。

概览

原生兼容端点

模型 API

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

按 ID 查询任务

请求头

路径参数

任务结果字段

公共可选控制参数

回调请求体示例

输入限制

图片

视频

音频

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​按 ID 查询任务

​请求头

​路径参数

​任务结果字段

​公共可选控制参数

​回调请求体示例

​输入限制

​图片

​视频

​音频

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

按 ID 查询任务

请求头

路径参数

任务结果字段

公共可选控制参数

回调请求体示例

输入限制

图片

视频

音频