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-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'
{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}
Seedance 2.5
Seedance 2.5 Draft-to-Video 样片转正式
- 把已完成的 Seedance 2.5 样片(创建时传了
draft: true的任务)转为同一内容的 1080p 正式视频 - 只接受
model、source_task_id、output_format、callback_url四个字段。提示词、素材、时长、宽高比、随机种子、音频设置全部沿用样片,不需要也不能重复传入,传入任何其它字段都会返回 400 参数错误 - 请在样片的
draft_expires_at之前提交转换请求。默认有效期为样片完成后 24 小时,实际截止时间以任务查询返回的draft_expires_at为准 - 系统会在受理和提交生成前检查有效期;排队期间过期会导致转换任务失败并退回本次费用,请预留排队时间
- 同一个样片在有效期内可以多次转换,每次单独计费
- 异步处理模式,使用返回的任务ID 进行查询,查询结果会带上
source_task_id - 生成的视频链接,有效期为24小时,请尽快保存
计费规则:
- 与样片分开计费,固定按
1080p计费 - 输出时长取源样片记录的实际产出时长,缺少实际值时使用源任务记录的有效输出时长
- 样片没有视频输入时,计费时长为输出时长;有视频输入时(含 Reference-to-Video、Video Edit、Video Extend),计费时长为
输出时长 + max(输入视频时长, 输出时长),向上取整到 0.1 秒 - 样片关闭了内容过滤(
content_filter: false)时,正式视频同样按 +10%(1.1x)计费 - 转换失败会退回本次费用,样片的费用不退
POST
/
v1
/
videos
/
generations
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-draft-to-video",
"source_task_id": "task-unified-1774857405-abc123"
}
'
{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-draft-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": false,
"estimated_time": 165,
"video_duration": 0
},
"type": "video",
"usage": {
"billing_rule": "per_second",
"credits_reserved": 50,
"user_group": "default"
}
}
授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
视频生成模型名称
可用选项:
seedance-2.5-draft-to-video 示例:
"seedance-2.5-draft-to-video"
已完成的 Seedance 2.5 样片任务的 Task ID
获取方式: 创建样片(draft: true)请求返回的 id 字段
要求:
- 任务必须属于当前账号
- 任务模型为 Seedance 2.5 的五个生成模型之一
- 任务创建时传了
draft: true - 任务状态为
completed - 当前时间早于该任务查询结果中的
draft_expires_at
示例:
"task-unified-1774857405-abc123"
输出容器格式,默认为 mp4
可选值:
mp4:H.264 编码,兼容性最好,标准色彩精度,此为默认值mov:H.264 + yuv444p 色度采样 + PCM 音频,色彩保真度更高,适合调色、抠像、合成等后期流程。浏览器内嵌播放可能不支持,请下载后使用 VLC / mpv / ffplay 播放。不额外收费
不继承样片的输出格式,需要 mov 时请在这里指定
可用选项:
mp4, mov 示例:
"mp4"
任务完成后的 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"
响应
转正式任务创建成功
任务创建时间戳
示例:
1761313744
任务ID
示例:
"task-unified-1774857405-abc123"
实际使用的模型名称
示例:
"seedance-2.5-draft-to-video"
任务的具体类型
可用选项:
video.generation.task 任务进度百分比 (0-100)
必填范围:
0 <= x <= 100示例:
0
任务状态
可用选项:
pending, processing, completed, failed 示例:
"pending"
视频任务详细信息
Show child attributes
Show child attributes
任务的输出类型
可用选项:
text, image, audio, video 示例:
"video"
使用量和计费信息
Show child attributes
Show child attributes