> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wan3.0 Image-to-Video 图生视频 > - 传入 `image_start` 严格指定视频**首帧**；再传 `image_end` 可同时严格指定**尾帧** - **不接受参考素材**（参考视频 / 参考音频 / 文件 / 网页）：首尾帧与参考素材互斥，如需混合参考请改用 [Wan3.0 参考生视频](/cn/api-manual/video-series/wan3.0/wan3.0-reference-video) - 最多 2 张图（首帧 + 尾帧）。需要 3 张及以上参考图请用参考生视频 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## 计费说明 - **计费公式**：计费时长 = 输入视频时长 + 输出视频时长，按秒计费 - **分辨率倍率**：`480p` = 1x（基准）、`720p` = 2x、`1080p` = 4x - 参考图片、参考音频、参考文件、网页链接**均不计费** - `duration` 传 `-1`（智能时长）时按 `30` 秒顶格预扣，任务成功后按实际产出时长结算，差额自动退回 - 开启或关闭 `audio` 音轨**价格相同** - **任务失败不计费**，已冻结额度全额退回 ## OpenAPI ````yaml cn/api-manual/video-series/wan3.0/wan3.0-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Image-to-Video 接口 description: 通义万相 3.0 图生视频，用首帧或首尾帧严格控制视频的起止画面 license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: 生产环境 security: - bearerAuth: [] tags: - name: 视频生成 description: AI视频生成相关接口 paths: /v1/videos/generations: post: tags: - 视频生成 summary: Wan3.0 Image-to-Video 图生视频 description: >- - 传入 `image_start` 严格指定视频**首帧**；再传 `image_end` 可同时严格指定**尾帧** - **不接受参考素材**（参考视频 / 参考音频 / 文件 / 网页）：首尾帧与参考素材互斥，如需混合参考请改用 [Wan3.0 参考生视频](/cn/api-manual/video-series/wan3.0/wan3.0-reference-video) - 最多 2 张图（首帧 + 尾帧）。需要 3 张及以上参考图请用参考生视频 - 异步处理模式，使用返回的任务ID [进行查询](/cn/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## 计费说明 - **计费公式**：计费时长 = 输入视频时长 + 输出视频时长，按秒计费 - **分辨率倍率**：`480p` = 1x（基准）、`720p` = 2x、`1080p` = 4x - 参考图片、参考音频、参考文件、网页链接**均不计费** - `duration` 传 `-1`（智能时长）时按 `30` 秒顶格预扣，任务成功后按实际产出时长结算，差额自动退回 - 开启或关闭 `audio` 音轨**价格相同** - **任务失败不计费**，已冻结额度全额退回 operationId: createWan30ImageToVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: first_frame: summary: 首帧生视频 value: model: wan3.0-image-to-video prompt: 画面中的少年从墙面中“活”过来，用极快的语速演唱一首英文 rap，夜晚铁路桥下的街灯营造出电影感氛围。 image_start: https://example.com/first_frame.png duration: 5 quality: 720p first_last_frame: summary: 首尾帧生视频 value: model: wan3.0-image-to-video prompt: 一个年轻女孩从微笑逐渐变为大笑，镜头缓缓推进，背景光线从冷色调渐变为暖色调。 image_start: https://example.com/first_frame.jpg image_end: https://example.com/last_frame.jpg duration: 5 quality: 720p aspect_ratio: '16:9' responses: '200': description: 视频生成任务创建成功 content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: 请求参数错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: 未认证、Token无效或过期 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: 配额不足、需要充值 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: 无权限访问 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan3.0-image-to-video' type: invalid_request_error '429': description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - image_start properties: model: type: string description: 模型名称，固定为 `wan3.0-image-to-video` enum: - wan3.0-image-to-video example: wan3.0-image-to-video default: wan3.0-image-to-video prompt: type: string description: |- 视频生成的文本提示词。支持中英文，**每个汉字/字母各占 1 个字符**，最大长度 `20000` 字符，超过部分会自动截断（不报错） 用于描述首帧（或首尾帧）之间期望发生的动作、镜头运动与画面变化。 example: 一个年轻女孩从微笑逐渐变为大笑，镜头缓缓推进，背景光线从冷色调渐变为暖色调。 image_start: type: string format: uri description: |- 首帧图片 URL，严格作为生成视频的第一帧。**必传** **图像限制：** - 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP - 分辨率：宽和高的范围为 `[240, 8000]` 像素 - 宽高比：1:8 ～ 8:1 - 文件大小：不超过 `20MB` example: https://example.com/first_frame.jpg image_end: type: string format: uri description: |- 尾帧图片 URL，严格作为生成视频的最后一帧。可选 **约束：** 必须与 `image_start` 搭配使用，**不支持只传尾帧**。 **图像限制：** - 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP - 分辨率：宽和高的范围为 `[240, 8000]` 像素 - 宽高比：1:8 ～ 8:1 - 文件大小：不超过 `20MB` example: https://example.com/last_frame.jpg duration: type: integer description: >- 生成视频的时长（秒），默认为 `5` **取值说明：** - `2` ~ `30` 之间的任意整数 - `-1`：智能时长，由模型根据提示词与输入素材自动决定输出长度 **智能时长的计费方式：** 提交时无法预知模型会生成多长，因此按上限 `30` 秒**顶格预扣**，任务成功后以实际产出时长结算，多冻结的部分自动退回。若余额不足以覆盖顶格预扣，请改用明确的秒数。 default: 5 example: 5 quality: type: string description: |- 视频分辨率，默认为 `720p` **可选值：** - `480p`：清晰度较低，价格最低（计费基准档） - `720p`：标准清晰度，此为默认值，价格为 `480p` 的 2 倍 - `1080p`：高清晰度，价格为 `480p` 的 4 倍 enum: - 480p - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: |- 视频宽高比，默认为 `adaptive` **可选值：** - `adaptive`：自适应，模型根据输入素材比例与提示词意图自动推荐合适的宽高比，此为默认值 - `16:9`（横屏）、`9:16`（竖屏）、`1:1`（方形）、`4:3`、`3:4` enum: - adaptive - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: adaptive example: '16:9' generate_audio: type: boolean description: |- 输出视频是否包含音轨，默认为 `true` **可选值：** - `true`：输出视频包含声音（人声、音效、背景音乐），此为默认值 - `false`：输出无声视频 **开关声音价格相同**，不额外收费。 default: true example: true seed: type: integer description: |- 随机种子，用于复现生成结果，默认随机 **说明：** - 取值范围：`0` ~ `2147483647` - 固定 seed 可在调试提示词时降低参数变化的干扰，提升结果可复现性 minimum: 0 maximum: 2147483647 example: 42 callback_url: type: string description: |- 任务完成后的 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 状态码视为成功，其他状态码触发重试 format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1761313744 id: type: string description: 任务ID example: task-unified-1774857405-abc123 model: type: string description: 实际使用的模型名称 example: wan3.0-image-to-video object: type: string enum: - video.generation.task description: 任务的具体类型 progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: 视频任务详细信息 type: type: string enum: - text - image - audio - video description: 任务的输出类型 example: video usage: $ref: '#/components/schemas/VideoUsage' description: 使用量和计费信息 ErrorResponse: type: object properties: error: type: object properties: code: type: string description: 错误代码标识符 message: type: string description: 错误描述信息 type: type: string description: 错误类型 VideoTaskInfo: type: object properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预估完成时间（秒） minimum: 0 example: 165 video_duration: type: integer description: 视频时长（秒） example: 8 VideoUsage: type: object description: 使用量和计费信息 properties: billing_rule: type: string description: 计费规则 enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: 预估消耗积分数 minimum: 0 example: 50 user_group: type: string description: 用户组类别 example: default securitySchemes: bearerAuth: type: http scheme: bearer description: |- ##所有接口均需要使用Bearer Token进行认证## **获取 API Key：** 访问 [API Key 管理页面](https://evolink.ai/dashboard/keys) 获取您的 API Key **使用时在请求头中添加：** ``` Authorization: Bearer YOUR_API_KEY ``` ````