curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-flash-text-to-video",
"prompt": "微距镜头对准叶片上翠绿的玻璃蛙。焦点逐渐从它光滑的皮肤,转移到它完全透明的腹部,一颗鲜红的心脏正在有力地、规律地收缩扩张。",
"duration": 8,
"quality": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"content_filter": true
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-flash-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: seedance-2.5-flash-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}Seedance 2.5 Flash 全参数指南
Seedance 2.5 Flash 整合参数文档。通过 model 选择本文件夹内的模型;各模式的必填字段、输入要求和计费规则分别列出。
样片限制: Seedance 2.5 Flash 不支持 draft: true 样片模式,也不提供样片转正式接口。
文生视频联网搜索: model_params.web_search: true 与 content_filter: false 不能同时使用,否则返回 400 参数错误。需要联网搜索时,请保持 content_filter: true(默认值)。
| 模型 ID | 模式 | 必填字段(不含 model) |
|---|---|---|
seedance-2.5-flash-text-to-video | Text-to-Video | prompt |
seedance-2.5-flash-image-to-video | Image-to-Video | prompt, image_urls |
seedance-2.5-flash-reference-to-video | Reference-to-Video | prompt |
seedance-2.5-flash-video-edit | Video Edit | prompt, video_urls |
seedance-2.5-flash-video-extend | Video Extend | prompt, video_urls |
Text-to-Video
- 纯文本提示词生成视频,支持联网搜索增强时效性
Image-to-Video
- 输入 1 张图片生成首帧视频,输入 2 张图片生成首尾帧视频,模型自动判断
Reference-to-Video
- 输入文本提示词,可选参考图片(0–10 张)、参考视频(0–5 个)和参考音频(0–5 段);允许不传素材,也允许只传音频。
- 适用于全新生成:图片、视频、音频作为风格、主体、运镜、配乐的参考
- 要改写或续接已有视频,请改用 Video Edit / Video Extend:本模型的提示词一旦带上编辑或延长意图,就会按编辑 / 延长任务校验参数,提交时不报错,任务跑起来才失败
Video Edit
- 对输入视频进行编辑——替换主体、增删物体、局部改写或换风格
- 提示词直接描述要怎么改即可,例如「去掉 @video1 中所有路人,只保留主角」
- 输入待编辑视频(必填)+ 可选参考图片(0–10)+ 参考视频(合计最多 5 个)+ 参考音频(0–5)
Video Extend
-
将输入视频向前或向后延长
-
提示词需明确说明延长意图(例如「向后延长 @video1,人物走出画面」)
-
输入待延长视频(必填)+ 可选参考图片(0–10)+ 参考视频(合计最多 5 个)+ 参考音频(0–5)
-
现已支持 AIGC 类真人素材
-
异步处理模式,使用返回的任务ID 进行查询
-
生成的视频链接,有效期为24小时,请尽快保存
curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "seedance-2.5-flash-text-to-video",
"prompt": "微距镜头对准叶片上翠绿的玻璃蛙。焦点逐渐从它光滑的皮肤,转移到它完全透明的腹部,一颗鲜红的心脏正在有力地、规律地收缩扩张。",
"duration": 8,
"quality": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"content_filter": true
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-flash-text-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 8
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}{
"error": {
"code": "invalid_parameter",
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"error": {
"code": "unauthorized",
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": "insufficient_quota",
"message": "Insufficient quota. Please top up your account.",
"type": "insufficient_quota"
}
}{
"error": {
"code": "model_access_denied",
"message": "Token does not have access to model: seedance-2.5-flash-text-to-video",
"type": "invalid_request_error"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests, please try again later",
"type": "rate_limit_error"
}
}{
"error": {
"code": "internal_error",
"message": "Internal server error",
"type": "api_error"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"type": "<string>"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
本页汇总各模式的参数。字段是否必填、可用取值和默认值按所选 model 的说明执行;下方分别列出各模式的差异。
视频生成模型名称
| 模型 ID | 模式 | 必填字段(不含 model) |
|---|---|---|
seedance-2.5-flash-text-to-video | Text-to-Video | prompt |
seedance-2.5-flash-image-to-video | Image-to-Video | prompt, image_urls |
seedance-2.5-flash-reference-to-video | Reference-to-Video | prompt |
seedance-2.5-flash-video-edit | Video Edit | prompt, video_urls |
seedance-2.5-flash-video-extend | Video Extend | prompt, video_urls |
seedance-2.5-flash-text-to-video, seedance-2.5-flash-image-to-video, seedance-2.5-flash-reference-to-video, seedance-2.5-flash-video-edit, seedance-2.5-flash-video-extend "seedance-2.5-flash-text-to-video"
Text-to-Video
描述期望生成视频的文本提示词。支持中英文,建议中文不超过 500 字,英文不超过 1000 词。提示词最大长度:10000 tokens
注意:
- 本模型为纯文生视频,不支持
image_urls、video_urls、audio_urls输入
Image-to-Video
描述期望生成视频的文本提示词。支持中英文,建议中文不超过 500 字,英文不超过 1000 词。提示词最大长度:10000 tokens
注意:
- 本模型不支持
video_urls、audio_urls输入
Reference-to-Video
描述期望生成视频的文本提示词。支持中英文,建议中文不超过 500 字。提示词最大长度:10000 tokens
说明:
- 在 prompt 中引用输入素材时,优先使用
@image1、@video1、@audio1这类显式标签,而不是仅使用「图片1」「视频1」「音频1」等自然语言表述 - 标签编号与对应 URL 数组的顺序一致并从 1 开始:
image_urls第一项为@image1,video_urls第一项为@video1,audio_urls第一项为@audio1 - 自然语言编号可能仍可被识别,但显式标签能更准确地建立素材与用途的对应关系
避免被判定为编辑 / 延长任务:
- 模型按提示词意图判定任务类型:出现「编辑视频、增加 / 加上、删除 / 去掉、修改 / 替换 / 改成」会被判为视频编辑;出现「向前 / 向后延长、延续、续写」会被判为视频延长
- 一旦被判为这两类任务,
aspect_ratio必须为adaptive、视频编辑的duration必须为-1,否则提交时不会报错,要等任务状态变成failed才能看到错误(错误码InvalidParameter.TaskTypeConstraint);失败会退回预扣额度,但等待的时间白花 - 确实要做编辑 / 延长,请直接改用
seedance-2.5-flash-video-edit、seedance-2.5-flash-video-extend:提交时即校验参数,不合法会立即同步报错 - 只做参考生成时,把「替换成 / 去掉」这类词改成描述性表达,例如「画面中出现 …」「以 @image1 的风格呈现 …」
Video Edit
描述期望编辑效果的文本提示词。支持中英文,建议中文不超过 500 字。提示词最大长度:10000 tokens
说明:
- 提示词必须写明编辑意图,例如「编辑视频:去掉 @video1 的背景音乐」
- 可用自然语言指明每个素材的用途,例如「把 @video1 中的人物替换成 @image1 中的人」
- 模型会自动理解素材编号与用途之间的对应关系
Video Extend
描述期望延长效果的文本提示词。支持中英文,建议中文不超过 500 字。提示词最大长度:10000 tokens
说明:
- 提示词必须写明延长意图,例如「向后延长 @video1,人物走出画面」
- 可用自然语言指明每个素材的用途,例如「按 @image1 的风格向前延长 @video1」
- 模型会自动理解素材编号与用途之间的对应关系
"微距镜头对准叶片上翠绿的玻璃蛙。焦点逐渐从它光滑的皮肤,转移到它完全透明的腹部,一颗鲜红的心脏正在有力地、规律地收缩扩张。"
仅适用于: Image-to-Video, Reference-to-Video, Video Edit, Video Extend
Image-to-Video
图片 URL 数组,1–2 张
图片数量与行为:
| 图片数量 | 行为 | 角色 |
|---|---|---|
| 1 张 | 首帧图生视频 | 自动设为 first_frame |
| 2 张 | 首尾帧图生视频 | 第 1 张 → first_frame,第 2 张 → last_frame |
图片要求:
- 支持格式:
.jpeg、.png、.webp - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 单张大小:不超过
30MB - 请求体总大小不超过
64MB - 传入首尾帧时,两张图片可相同。宽高比不一致时以首帧为准,尾帧会自动裁剪适配
- 图像 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Reference-to-Video
参考图片 URL 数组,可不传;传入时为 1–10 张
素材均可选: image_urls、video_urls、audio_urls 可以全部省略,也可以只提供 audio_urls。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 图片 | reference_image | 风格参考、产品图、首帧/尾帧(通过 prompt 指定) |
图片要求:
- 支持格式:
.jpeg、.png、.webp - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 单张大小:不超过
30MB - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 图像 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Video Edit
参考图片 URL 数组,可不传;传入时为 1–10 张
必填关系: 本模型 video_urls 必填,图片为可选的补充参考素材。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 图片 | reference_image | 风格参考、产品图、替换主体(通过 prompt 指定) |
图片要求:
- 支持格式:
.jpeg、.png、.webp - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 单张大小:不超过
30MB - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 图像 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Video Extend
参考图片 URL 数组,可不传;传入时为 1–10 张
必填关系: 本模型 video_urls 必填,图片为可选的补充参考素材。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 图片 | reference_image | 风格参考、产品图、场景参考(通过 prompt 指定) |
图片要求:
- 支持格式:
.jpeg、.png、.webp - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 单张大小:不超过
30MB - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 图像 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
10["https://example.com/first-frame.jpg"]
仅适用于: Reference-to-Video, Video Edit, Video Extend
Reference-to-Video
参考视频 URL 数组,可不传;传入时为 1–5 个
素材均可选: image_urls、video_urls、audio_urls 可以全部省略,也可以只提供 audio_urls。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 视频 | reference_video | 运镜参考、动作参考、待编辑/延长的原始视频 |
视频要求:
- 支持格式:
.mp4、.mov - 分辨率:480p、720p、1080p、4K
- 单个视频时长:
2~30秒,最多 5 个,所有视频总时长 ≤30秒 - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 画面像素(宽 × 高):
409,600~8,295,044(如 640×640 ~ 3326×2494) - 单个大小:不超过
200MB - 帧率:
24~60FPS - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 具体编码、分辨率等素材有效性由模型进一步校验
- 使用视频参考会增加费用(输入视频时长计入计费)
- 视频 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Video Edit
输入视频 URL 数组,必填;1–5 个
必填关系: 至少提供 1 个视频——即待编辑的视频。第一个视频为被编辑对象,其余视频作为参考素材。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 视频 | reference_video | 待编辑的视频(第一个)、运镜或动作参考(其余) |
视频要求:
- 支持格式:
.mp4、.mov - 分辨率:480p、720p、1080p、4K
- 单个视频时长:
4~30秒(第一个视频为编辑对象),最多 5 个,所有视频总时长 ≤30秒 - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 画面像素(宽 × 高):
409,600~8,295,044(如 640×640 ~ 3326×2494) - 单个大小:不超过
200MB - 帧率:
24~60FPS - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 具体编码、分辨率等素材有效性由模型进一步校验
- 使用视频参考会增加费用(输入视频时长计入计费)
- 视频 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Video Extend
输入视频 URL 数组,必填;1–5 个
必填关系: 至少提供 1 个视频——即待延长的视频。第一个视频为被延长对象,其余视频作为参考素材。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 视频 | reference_video | 待延长的视频(第一个)、运镜或动作参考(其余) |
视频要求:
- 支持格式:
.mp4、.mov - 分辨率:480p、720p、1080p、4K
- 单个视频时长:
2~30秒,最多 5 个,所有视频总时长 ≤30秒 - 宽高比(宽/高):
0.4~2.5 - 宽高像素:
300~6000px - 画面像素(宽 × 高):
409,600~8,295,044(如 640×640 ~ 3326×2494) - 单个大小:不超过
200MB - 帧率:
24~60FPS - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 具体编码、分辨率等素材有效性由模型进一步校验
- 使用视频参考会增加费用(输入视频时长计入计费)
- 视频 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
5["https://example.com/reference.mp4"]
仅适用于: Reference-to-Video, Video Edit, Video Extend
Reference-to-Video
参考音频 URL 数组,可不传;传入时为 1–5 段
素材均可选: image_urls、video_urls、audio_urls 可以全部省略,也可以只提供 audio_urls。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 音频 | reference_audio | 背景音乐、音效、语音/台词参考 |
音频要求:
- 支持格式:
.wav、.mp3 - 单段音频时长:
2~30秒,最多 5 段,所有音频总时长 ≤30秒 - 单个大小:不超过
15MB - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 音频 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
Video Edit / Video Extend
参考音频 URL 数组,可不传;传入时为 1–5 段
必填关系: 本模型 video_urls 必填,音频为可选的补充参考素材。
角色说明:
| 媒体类型 | 角色 | 典型用途 |
|---|---|---|
| 音频 | reference_audio | 背景音乐、音效、语音/台词参考 |
音频要求:
- 支持格式:
.wav、.mp3 - 单段音频时长:
2~30秒,最多 5 段,所有音频总时长 ≤30秒 - 单个大小:不超过
15MB - 请求体总大小不超过
64MB,请勿使用 Base64 编码 - 音频 URL 需要服务器能直接访问
素材地址: 支持公网可访问的 HTTP(S) URL,也支持当前上游账号可访问的 asset:// 素材 ID。
5["https://example.com/bgm.mp3"]
Text-to-Video / Image-to-Video
视频时长(秒),默认为 5 秒
说明:
- 支持
4–30秒之间的任意整数值 -1:自动时长,由模型在4–30秒内自行决定,按实际产出时长计费- 时长与计费直接相关
Reference-to-Video
输出视频时长(秒),默认为 5 秒
说明:
- 支持
4–30秒之间的任意整数值 -1:自动时长,由模型在4–30秒内自行决定,按实际产出时长计费- 时长与计费直接相关
若提示词被判为视频编辑任务,仅 -1 合法,传具体秒数会让任务失败,且提交时不报错
Video Edit
输出视频时长(秒),默认为 -1
说明:
- 仅支持
-1:输出时长跟随输入视频(可能比输入短最多 0.4 秒) - 不接受自定义时长,传具体秒数会被拒绝
- 时长与计费直接相关
Video Extend
输出视频时长(秒),默认为 5 秒
说明:
- 支持
4–30秒之间的任意整数值 -1:自动时长,按实际产出时长计费- 时长与计费直接相关
-1 8
Text-to-Video
视频宽高比,默认为 adaptive
可选值:
16:9(横屏)、9:16(竖屏)、1:1(方形)、4:3、3:4、21:9(超宽屏)adaptive:模型根据提示词智能选择最佳宽高比
各分辨率对应像素值:
| 宽高比 | 480p | 720p |
|---|---|---|
| 16:9 | 854×480 | 1280×720 |
| 4:3 | 752×560 | 1112×834 |
| 1:1 | 640×640 | 960×960 |
| 3:4 | 560×752 | 834×1112 |
| 9:16 | 480×854 | 720×1280 |
| 21:9 | 992×432 | 1470×630 |
Image-to-Video
视频宽高比,图生视频仅支持 adaptive
可选值:
adaptive:根据首帧图片比例自动选择最接近的宽高比,这是本模型唯一可传的值- 本模型不支持手动指定
16:9、9:16等固定比例
Reference-to-Video
视频宽高比,默认为 adaptive
可选值:
16:9(横屏)、9:16(竖屏)、1:1(方形)、4:3、3:4、21:9(超宽屏)adaptive:根据提示词意图判断,优先级:视频 > 图片 > 提示词
各分辨率对应像素值:
| 宽高比 | 480p | 720p |
|---|---|---|
| 16:9 | 854×480 | 1280×720 |
| 4:3 | 752×560 | 1112×834 |
| 1:1 | 640×640 | 960×960 |
| 3:4 | 560×752 | 834×1112 |
| 9:16 | 480×854 | 720×1280 |
| 21:9 | 992×432 | 1470×630 |
若提示词被判为视频编辑 / 视频延长任务,仅 adaptive 合法,传固定比例会让任务失败,且提交时不报错
Video Edit / Video Extend
视频宽高比,默认为 adaptive
可选值:
adaptive:输出比例跟随第一个输入视频,这是本模型唯一可传的值- 传
16:9、9:16等固定比例会被拒绝
16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive "16:9"
任务完成后的 HTTPS 回调地址
回调时机:
- 任务完成(completed)或失败(failed)时触发
- 在计费确认完成后发送
安全限制:
- 仅支持 HTTPS 协议
- 禁止回调到内网 IP 地址(127.0.0.1、10.x.x.x、172.16-31.x.x、192.168.x.x 等)
- URL 长度不超过
2048字符
回调机制:
- 超时时间:
10秒 - 失败后最多重试
3次(分别在失败后1/2/4秒重试) - 回调响应体格式与任务查询接口返回格式一致
- 返回 2xx 状态码视为成功,其他状态码触发重试
"https://your-domain.com/webhooks/video-task-completed"
响应
视频生成任务创建成功