> ## Documentation Index > Fetch the complete documentation index at: https://docs.vidgo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan Animate Move > Wan Animate Move API 将参考视频中的动作迁移到图片中的角色上，让角色动起来。 > [!TIP] > > 1. 使用 `VIDGO_API_KEY` 提交请求。Vidgo 会在创建任务前校验请求并检查源视频。任务创建成功后返回 `task_id`。 > 2. 使用返回的 `task_id` 调用[查询任务状态](https://docs.vidgo.ai/zh/api-manual/task-management/status.md)，直到任务变为 `finished` 或 `failed`。如果提供了 `callback_url`，任务完成或失败时 Vidgo 还会将结果发送到你的 [Webhook](https://docs.vidgo.ai/zh/api-manual/task-management/webhooks.md)。 使用 Wan Animate Move，将参考视频中的动作迁移到图片中的角色上，让角色动起来。 ## 模型 * **alibaba/wan/v2.2-14b/animate/move** - 使用 Wan Animate Move，将参考视频中的动作迁移到图片中的角色上，让角色动起来。 ## 功能 * 使用 Wan Animate Move，将参考视频中的动作迁移到图片中的角色上，让角色动起来。 * 接受只含一个图片 URL 的 `image_urls` 数组。 * 支持 `480p`、`580p` 和 `720p` 输出分辨率。 ## 源视频要求 * `video_url` 必须指向可公开访问的 HTTP(S) 视频文件。 * 整个视频文件不超过 **100 MiB**（104,857,600 字节），且时长大于零。 * Vidgo 会读取源视频以确定计费时长。 ## 请求参数 `model` 和可选的 `callback_url` 放在请求根级。`input` 对象只接受 `video_url`、`image_urls` 和 `resolution`。 不支持的 `input` 字段会在扣除积分前被拒绝。输入 URL 必须使用 HTTP(S)，带主机名，且不含内嵌凭证或空白字符。 ### 源视频 * `video_url`：必填字符串。为角色图片提供动作的参考视频，须满足上述源视频要求。 ### 角色图片 * `image_urls`：必填数组，只包含一个可公开访问的 HTTP(S) 图片 URL，即包含要驱动角色的图片。传入单个 URL 字符串而非数组、空数组、多个 URL 以及 Base64 图片都会被拒绝。 ### 分辨率 * `resolution`：可选字符串。可选值：`480p`、`580p`、`720p`。仅在省略该字段时默认 `480p`。null、空字符串、其他取值以及带首尾空白的取值都会被拒绝。 ## 计费因素 计费取决于所选分辨率（`resolution`）和检测到的源视频时长（`video_url`）。Move 和 Replace 使用相同费率。 计费前源视频时长会向上取整到整秒。例如，时长 5.1 秒的源视频按 6 秒计费。如果 Vidgo 无法读取视频或确定其时长，请求会在扣除积分前被拒绝。 有效请求提交生成时扣除积分，任务失败后退还。 ## OpenAPI ````yaml zh/api-manual/video-series/alibaba-wan-v2-2-14b-animate-move.json POST /api/generate/submit openapi: 3.0.0 info: title: Vidgo API - Wan Animate Move description: 使用 Wan Animate Move，将参考视频中的动作迁移到图片中的角色上，让角色动起来。 version: 1.0.0 servers: - url: https://api.vidgo.ai security: - BearerAuth: [] paths: /api/generate/submit: post: tags: - Video Series summary: Wan Animate Move description: >- 使用 Wan Animate Move，将参考视频中的动作迁移到图片中的角色上，让角色动起来。 model 和可选的 callback_url 放在请求根级。input 对象只接受 video_url、image_urls 和 resolution。不支持的 input 字段会在扣除积分前被拒绝。 输入 URL 必须使用 HTTP(S)，带主机名，且不含内嵌凭证或空白字符。源视频必须可公开访问，整个文件不超过 100 MiB（104,857,600 字节），且时长大于零。Vidgo 会在创建任务前校验请求并检查源视频。任务创建成功后返回 task_id。可查询任务状态或提供 callback_url 来获取结果。 计费取决于所选分辨率和向上取整到整秒的源视频时长。Move 和 Replace 使用相同费率。时长 5.1 秒的源视频按 6 秒计费。视频检测失败的请求会在扣除积分前被拒绝。有效请求提交生成时扣除积分，任务失败后退还。 operationId: submit_alibaba_wan_v2_2_14b_animate_move requestBody: required: true content: application/json: schema: type: object required: - model - input additionalProperties: true properties: model: type: string example: alibaba/wan/v2.2-14b/animate/move input: type: object required: - image_urls - video_url properties: video_url: type: string format: uri description: >- 必填字符串。为角色图片提供动作的参考视频。使用可公开访问、带主机名、不含内嵌凭证或空白字符的 HTTP(S) URL。整个视频文件不超过 100 MiB（104,857,600 字节），且时长大于零。Vidgo 会检测源视频时长用于计费。 image_urls: type: array items: type: string format: uri description: 可公开访问的 HTTP(S) 图片 URL，带主机名，不含内嵌凭证或空白字符。 minItems: 1 maxItems: 1 description: >- 必填数组，只包含一个可公开访问的 HTTP(S) 图片 URL，即包含要驱动角色的图片。传入单个 URL 字符串而非数组、空数组、多个 URL 以及 Base64 图片都会被拒绝。URL 必须带主机名，且不含内嵌凭证或空白字符。 resolution: type: string enum: - 480p - 580p - 720p default: 480p description: >- 可选字符串：480p、580p 或 720p。仅在省略时默认 480p。null、空字符串、其他取值以及带首尾空白的取值都会被拒绝。所选分辨率决定每秒源视频的计费费率。计算总量前，源视频时长会向上取整到整秒。 additionalProperties: false callback_url: type: string nullable: true description: >- 可选的公开 HTTP(S) 地址，用于接收任务完成通知。建议使用 HTTPS。省略、设为 null 或空字符串即不发送回调。 description: model 和 callback_url 放在根级。未知的根级字段会被忽略；不支持的 input 字段会被拒绝。 examples: basic: summary: 基础工作流 value: model: alibaba/wan/v2.2-14b/animate/move input: image_urls: - https://example.com/image.png video_url: https://example.com/video.mp4 resolution: 480p callback: summary: 接收完成回调 value: model: alibaba/wan/v2.2-14b/animate/move input: image_urls: - https://example.com/image.png video_url: https://example.com/video.mp4 resolution: 480p callback_url: https://your-domain.com/callback responses: '200': description: 任务创建成功。使用返回的 task_id 查询任务状态并获取结果。 content: application/json: schema: type: object required: - code - data properties: code: type: integer enum: - 200 data: type: object required: - task_id - status - created_time properties: task_id: type: string status: type: string enum: - not_started - running - finished - failed created_time: type: string format: date-time example: code: 200 data: task_id: task-unified-example status: running created_time: '2026-09-10T08:00:00' '400': description: 输入参数无效或不受支持、源视频无法访问、视频超过 100 MiB 或时长非正数或无法读取，或积分不足。 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '401': description: 凭证无效 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '403': description: 拒绝访问 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '404': description: 模型不存在或已停用 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '408': description: 请求超时 content: text/plain: schema: type: string example: Request timeout '422': description: JSON 无效或请求体不是对象 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '429': description: 超出频率限制或 API Key 积分限额 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '500': description: 内部错误 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '502': description: 无法创建视频生成任务。 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} '503': description: 所选模型当前不可用。 content: application/json: schema: type: object required: - detail properties: detail: oneOf: - type: string - type: object additionalProperties: true - type: array items: {} components: securitySchemes: BearerAuth: type: http scheme: bearer description: 使用 VIDGO_API_KEY。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.