curl --request POST \
--url https://api.evolink.ai/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "wan3.0-image-to-video",
"prompt": "画面中的少年从墙面中“活”过来，用极快的语速演唱一首英文 rap，夜晚铁路桥下的街灯营造出电影感氛围。",
"image_start": "https://example.com/first_frame.png",
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"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: wan3.0-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"
}
}Wan3.0
Wan3.0 Image-to-Video 图生视频
- 传入
image_start严格指定视频首帧；再传image_end可同时严格指定尾帧 - 不接受参考素材（参考视频 / 参考音频 / 文件 / 网页）：首尾帧与参考素材互斥，如需混合参考请改用 Wan3.0 参考生视频
- 最多 2 张图（首帧 + 尾帧）。需要 3 张及以上参考图请用参考生视频
- 异步处理模式，使用返回的任务ID 进行查询
- 生成的视频链接，有效期为24小时，请尽快保存
计费说明
- 计费公式：计费时长 = 输入视频时长 + 输出视频时长，按秒计费
- 分辨率倍率：
480p= 1x（基准）、720p= 2x、1080p= 4x - 参考图片、参考音频、参考文件、网页链接均不计费
duration传-1（智能时长）时按30秒顶格预扣，任务成功后按实际产出时长结算，差额自动退回- 开启或关闭
generate_audio音轨价格相同 - 任务失败不计费，已冻结额度全额退回
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": "wan3.0-image-to-video",
"prompt": "画面中的少年从墙面中“活”过来，用极快的语速演唱一首英文 rap，夜晚铁路桥下的街灯营造出电影感氛围。",
"image_start": "https://example.com/first_frame.png",
"duration": 5,
"quality": "720p"
}
'{
"created": 1761313744,
"id": "task-unified-1774857405-abc123",
"model": "wan3.0-image-to-video",
"object": "video.generation.task",
"progress": 0,
"status": "pending",
"task_info": {
"can_cancel": true,
"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: wan3.0-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
模型名称，固定为 wan3.0-image-to-video
可用选项:
wan3.0-image-to-video 示例:
"wan3.0-image-to-video"
首帧图片 URL，严格作为生成视频的第一帧。必传
图像限制：
- 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP
- 分辨率：宽和高的范围为
[240, 8000]像素 - 宽高比：1:8 ～ 8:1
- 文件大小：不超过
20MB
示例:
"https://example.com/first_frame.jpg"
视频生成的文本提示词。支持中英文，每个汉字/字母各占 1 个字符，最大长度 20000 字符，超过部分会自动截断（不报错）
用于描述首帧（或首尾帧）之间期望发生的动作、镜头运动与画面变化。
示例:
"一个年轻女孩从微笑逐渐变为大笑，镜头缓缓推进，背景光线从冷色调渐变为暖色调。"
尾帧图片 URL，严格作为生成视频的最后一帧。可选
约束： 必须与 image_start 搭配使用，不支持只传尾帧。
图像限制：
- 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP
- 分辨率：宽和高的范围为
[240, 8000]像素 - 宽高比：1:8 ～ 8:1
- 文件大小：不超过
20MB
示例:
"https://example.com/last_frame.jpg"
生成视频的时长（秒），默认为 5
取值说明：
2~30之间的任意整数-1：智能时长，由模型根据提示词与输入素材自动决定输出长度
智能时长的计费方式： 提交时无法预知模型会生成多长，因此按上限 30 秒顶格预扣，任务成功后以实际产出时长结算，多冻结的部分自动退回。若余额不足以覆盖顶格预扣，请改用明确的秒数。
示例:
5
视频分辨率，默认为 720p
可选值：
480p：清晰度较低，价格最低（计费基准档）720p：标准清晰度，此为默认值，价格为480p的 2 倍1080p：高清晰度，价格为480p的 4 倍
可用选项:
480p, 720p, 1080p 示例:
"720p"
视频宽高比，默认为 adaptive
可选值：
adaptive：自适应，模型根据输入素材比例与提示词意图自动推荐合适的宽高比，此为默认值16:9（横屏）、9:16（竖屏）、1:1（方形）、4:3、3:4
可用选项:
adaptive, 16:9, 9:16, 1:1, 4:3, 3:4 示例:
"16:9"
输出视频是否包含音轨，默认为 true
可选值：
true：输出视频包含声音（人声、音效、背景音乐），此为默认值false：输出无声视频
开关声音价格相同，不额外收费。
示例:
true
随机种子，用于复现生成结果，默认随机
说明：
- 取值范围：
0~2147483647 - 固定 seed 可在调试提示词时降低参数变化的干扰，提升结果可复现性
必填范围:
0 <= x <= 2147483647示例:
42
任务完成后的 HTTPS 回调地址
回调时机：
- 任务完成（completed）、失败（failed）或取消（cancelled）时触发
- 在计费确认完成后发送
安全限制：
- 仅支持 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"
实际使用的模型名称
示例:
"wan3.0-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