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-image-to-video",
"prompt": "镜头缓缓推近，画面逐渐活起来",
"image_urls": [
"https://example.com/first-frame.jpg"
],
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-flash-image-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-image-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"
}
}Seedance 2.5
Seedance 2.5 Flash Image-to-Video 图生视频
- 输入 1 张图片生成首帧视频，输入 2 张图片生成首尾帧视频，模型自动判断
- 异步处理模式，使用返回的任务ID 进行查询
- 生成的视频链接，有效期为24小时，请尽快保存
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-flash-image-to-video",
"prompt": "镜头缓缓推近，画面逐渐活起来",
"image_urls": [
"https://example.com/first-frame.jpg"
],
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "seedance-2.5-flash-image-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-image-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"
}
}授权
##所有接口均需要使用Bearer Token进行认证##
获取 API Key：
访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY
请求体
application/json
视频生成模型名称
可用选项:
seedance-2.5-flash-image-to-video 示例:
"seedance-2.5-flash-image-to-video"
描述期望生成视频的文本提示词。支持中英文，建议中文不超过 500 字，英文不超过 1000 词。提示词最大长度：10000 tokens
注意：
- 本模型不支持
video_urls、audio_urls输入
示例:
"镜头缓缓推近，画面逐渐活起来"
图片 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 需要服务器能直接访问
Required array length:
1 - 2 elements示例:
["https://example.com/first-frame.jpg"]
视频时长（秒），默认为 5 秒
说明：
- 支持
4–30秒之间的任意整数值 - 不支持
-1自动时长，传入会返回 400 参数错误 - 时长与计费直接相关
计费规则：
- 按秒计费，计费时长为输出时长（即
duration）
必填范围:
4 <= x <= 30示例:
5
视频分辨率，默认为 720p
可选值：
480p：清晰度较低，价格较低720p：标准清晰度，此为默认值
可用选项:
480p, 720p 示例:
"720p"
视频宽高比，图生视频仅支持 adaptive
可选值：
adaptive：输出比例跟随首帧图片，也可以不传此参数- 本模型不支持手动指定
16:9、9:16等固定比例
可用选项:
adaptive 示例:
"adaptive"
是否生成同步音频，默认为 true
可选值：
true：视频包含同步音频，不额外收费false：输出无声视频
示例:
true
任务完成后的 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-flash-image-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