curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan-animate-replace",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "video_url": "https://example.com/source.mp4",
    "image_urls": [
      "https://example.com/replace.jpg"
    ],
    "resolution": "480p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "wan-animate-replace",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "video_url": "https://example.com/source.mp4",
    "image_urls": [
      "https://example.com/replace.jpg"
    ],
    "resolution": "480p"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the response result through the unified Query Task Status endpoint.

Wan Animate Video Generation

Wan Animate is powered by Alibaba’s Wan2.2-Animate model, a 14B parameter open-source model for digital human video generation. It accurately captures facial expressions and body movements from a reference video and applies them to a target image, enabling seamless character animation and replacement with realistic lighting and color preservation.

Available Models

wan-animate-replace - Replace a character in a video with one from a source image while preserving expressions and movements
wan-animate-move - Animate a character image using motion from a reference video

Resolution Options

480p - Standard definition (default)
580p - Enhanced definition
720p - HD quality

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Wan Animate model identifier

Available options:

wan-animate-replace,

wan-animate-move

input

object

required

Input parameters for animation

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

200 - application/json

Task submitted successfully

code

integer

required

HTTP status code

Example:

200

data

object

required

Show child attributes

Wan 2.2 Image-to-Video Fast Kling 3.0 Video Generation

Overview

Image Series

Video Series

Music Series

File Management

Task Management

Account Management

Wan Animate Video Generation

Wan Animate Video Generation

Available Models

Resolution Options

Authorizations

Body

Response

​Wan Animate Video Generation

​Available Models

​Resolution Options

Authorizations

Body

Response

Wan Animate Video Generation

Available Models

Resolution Options