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
任务完成后的 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"
响应
视频生成任务创建成功