curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "alibaba/wan/v2.2-14b/animate/replace",
  "input": {
    "image_urls": [
      "https://example.com/image.png"
    ],
    "video_url": "https://example.com/video.mp4",
    "resolution": "480p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

"Request timeout"

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

​

Wan Animate Replace

Replace the character in a source video with the character from a reference image using Wan Animate Replace.

​

Available Models

• alibaba/wan/v2.2-14b/animate/replace - Replace the character in a source video with the character from a reference image using Wan Animate Replace.

​

Source Video Requirements

• video_url must point to a publicly accessible HTTP(S) video file.
• The entire video file must be no larger than 100 MiB (104,857,600 bytes), and its duration must be greater than zero.
• Vidgo reads the source video to determine its duration for billing. This endpoint does not accept a duration field.

​

Key Features

• Replace the character in a source video with the character from a reference image using Wan Animate Replace.
• Accepts an image_urls array containing exactly one image URL.
• Supports 480p, 580p, and 720p output resolutions.

​

Request Parameters

Set model and optional callback_url at the request root. The input object accepts only video_url, image_urls, and resolution. It does not accept prompt, text, or duration. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials or whitespace.

​

Source Video

• video_url: Required string. The source video containing the character to replace. The video must meet the source video requirements above.

​

Character Image

• image_urls: Required array containing exactly one publicly accessible HTTP(S) image URL. The reference image containing the replacement character. A single URL string instead of an array, an empty array, multiple URLs, and Base64 images are rejected.

​

Resolution

• resolution: Optional string. Accepted values: 480p, 580p, 720p. Defaults to 480p only when the field is omitted. Null, empty strings, other values, and values with surrounding whitespace are rejected.

​

Pricing

Move and Replace use the same per-second rates: Vidgo measures the source video duration for billing. Whole seconds are billed as measured; any fractional second is rounded up to a whole second. Total credits = ceil(source video duration in seconds) × credits per second. For example, a 5.1-second source video at 480p is billed as 6 seconds: 42 credits ($0.210). Do not send a duration field. If Vidgo cannot read the video or determine its duration, the request is rejected before credits are deducted. Credits are deducted when a valid request is submitted for generation and refunded if the task fails.