seedance-2.5

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

创建任务

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/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

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

数据交换格式。

请求体

string

required

AnyFast 国内站模型 ID，使用 seedance-2.5。

object[]

required

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

string

required

提示词项使用 text。

string

required

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

boolean

default:true

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

string

default:"720p"

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

string

default:"adaptive"

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

integer

default:-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.com.cn/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

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

数据交换格式。

请求体

string

required

AnyFast 国内站模型 ID，使用 seedance-2.5。

string

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

object[]

required

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

string

required

内容类型：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

required

素材角色：reference_image、reference_video 或 reference_audio。

boolean

default:true

生成同步音频。

string

default:"720p"

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

string

default:"adaptive"

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

integer

default:-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.com.cn/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

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

数据交换格式。

请求体

string

required

AnyFast 国内站模型 ID，使用 seedance-2.5。

string

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

object[]

required

编辑指令和源素材。

string

required

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

string

required

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

string

required

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

string

required

源视频使用 reference_video。

boolean

default:true

生成同步音频。

string

default:"720p"

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

string

default:"adaptive"

required

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

integer

default:-1

required

视频编辑仅支持 -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.com.cn/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

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

数据交换格式。

请求体

string

required

AnyFast 国内站模型 ID，使用 seedance-2.5。

string

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

object[]

required

延长指令和参考素材。

string

required

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

string

required

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

string

required

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

string

required

视频素材使用 reference_video。

boolean

default:true

生成同步音频。

string

default:"720p"

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

string

default:"adaptive"

required

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

integer

default:-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.com.cn/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

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

string

default:"application/json"

required

数据交换格式。

请求体

string

required

AnyFast 国内站模型 ID，使用 seedance-2.5。

object[]

required

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

string

required

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

string

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

string

required

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

string

required

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

boolean

default:true

生成同步音频。

string

default:"720p"

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

string

default:"adaptive"

required

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

integer

default:-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 秒级时间戳。

创建 Draft

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "content": [{
      "type": "text",
      "text": "黄昏时分，一只红色小纸船缓缓划过雨后的水洼"
    }],
    "draft": true,
    "resolution": "480p",
    "duration": 5,
    "ratio": "16:9",
    "generate_audio": true,
    "seed": 20,
    "output_format": "mov"
  }'

boolean

required

创建 480p Draft 时设为 true。

string

required

Draft 创建阶段仅支持 480p。

object[]

required

用于生成 Draft 的提示词和全部输入素材。

Draft 创建响应

200

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

轮询 Draft 任务直到 data.status 为 SUCCESS。终态结果结构如下：

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_draft",
    "status": "SUCCESS",
    "result_url": "https://example.com/draft-video.mov",
    "progress": "100%",
    "data": {
      "content": {
        "video_url": "https://example.com/draft-video.mov"
      },
      "draft": true,
      "duration": 5,
      "generate_audio": true,
      "ratio": "16:9",
      "resolution": "480p",
      "output_format": "mov",
      "seed": 20,
      "status": "succeeded",
      "usage": {
        "completion_tokens": 48437,
        "total_tokens": 48437
      }
    }
  }
}

创建 Final

POST /v1/video/generations

cURL

curl --request POST \
  --url https://www.anyfast.com.cn/v1/video/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2.5",
    "content": [{
      "type": "draft_task",
      "draft_task": {
        "id": "asyntask_example_draft"
      }
    }],
    "draft": false,
    "resolution": "1080p",
    "output_format": "mov",
    "return_last_frame": true,
    "priority": 2
  }'

string

required

Final 请求使用 draft_task。

string

required

Draft 创建请求返回的公开 asyntask_... ID。

boolean

required

创建 Final 时设为 false。

string

required

Seedance 2.5 Final 渲染使用 1080p。

Final 会继承 Draft 的提示词、输入素材、duration、ratio、seed、generate_audio 和 omni_reference_task_type，请勿重复传入继承字段。Final 可以设置 return_last_frame、output_format、watermark、service_tier、execution_expires_after、priority、callback_url 和 safety_identifier。

Final 任务结果

200

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "asyntask_example_final",
    "status": "SUCCESS",
    "result_url": "https://example.com/final-video.mov",
    "progress": "100%",
    "data": {
      "content": {
        "video_url": "https://example.com/final-video.mov",
        "last_frame_url": "https://example.com/final-frame.jpeg"
      },
      "draft": false,
      "draft_task_id": "cgt-example-provider-draft",
      "duration": 5,
      "generate_audio": true,
      "ratio": "16:9",
      "resolution": "1080p",
      "output_format": "mov",
      "seed": 20,
      "status": "succeeded",
      "usage": {
        "completion_tokens": 245025,
        "total_tokens": 245025
      }
    }
  }
}

boolean

Draft 结果为 true，Final 结果为 false。

string

Final 关联的 Draft 任务；该字段可能为上游任务 ID，请另外保存公开 AnyFast Draft ID。

string

生成的 Draft 或 Final 视频地址。

string

return_last_frame 为 true 时返回的尾帧图片地址。

integer

本任务计费的生成 Token 数。

integer

本任务计费的总 Token 数。

Draft 自创建起 7 天内有效，Draft 与 Final 是两个独立计费任务，且两次请求的模型 ID 必须一致。execution_expires_after 和 safety_identifier 可能被服务规范化，不保证原样回显。

按 ID 查询任务

GET /v1/video/generations/{id}

cURL

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

请求头

string

required

Bearer 鉴权，格式为 Bearer YOUR_API_KEY。

路径参数

string

required

创建请求返回的任务 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} 返回的任务结果一致。

回调请求体示例

AnyFast 会将任务结果作为 POST 请求体发送到 callback_url。

成功
失败

{
  "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": {
      "status": "succeeded",
      "model": "provider-model-id",
      "duration": 5,
      "resolution": "720p"
    }
  }
}

{
  "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": {
      "status": "failed",
      "model": "provider-model-id",
      "error": {
        "code": "TaskFailed",
        "message": "The video generation task failed."
      }
    }
  }
}

失败回调中的 code: "success" 表示任务结果已成功返回；视频生成结果以 data.status 为准。

integer

default:172800

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

integer

default:0

任务执行优先级。

string

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

integer

default:-1

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

string

default:"default"

任务服务等级。

string

default:"mp4"

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

boolean

default:false

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

boolean

default: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

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建 Draft

Draft 创建响应

创建 Final

Final 任务结果

按 ID 查询任务

请求头

路径参数

任务结果字段

公共可选控制参数

回调请求体示例

输入限制

图片

视频

音频

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建任务

​请求头

​请求体

​创建响应

​创建 Draft

​Draft 创建响应

​创建 Final

​Final 任务结果

​按 ID 查询任务

​请求头

​路径参数

​任务结果字段

​公共可选控制参数

​回调请求体示例

​输入限制

​图片

​视频

​音频

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建任务

请求头

请求体

创建响应

创建 Draft

Draft 创建响应

创建 Final

Final 任务结果

按 ID 查询任务

请求头

路径参数

任务结果字段

公共可选控制参数

回调请求体示例

输入限制

图片

视频

音频