Wan Animate LoRA

Overview

Wan Animate LoRA is an asynchronous character animation model. It uses one source image as the character reference and one motion video as the movement reference, then returns a generated MP4 video.

Capability	Value
Model ID	`wan-animate-LoRA`
Mode	`animate` (required)
Source image	Exactly 1 URL in `image_urls`
Motion video	Exactly 1 public HTTPS video URL in `video_urls`
Resolution	`480p`, `720p`
Billing duration	Detected from `video_urls[0]`, billed to 3 decimal places with a 5-second minimum
Seed	Optional integer from `0` to `2147483647`

Endpoint and authentication

Base URL:

https://api.apixo.ai/api/v1

Method	Endpoint	Purpose
`POST`	`/generateTask/wan-animate-LoRA`	Submit an animation task
`GET`	`/statusTask/wan-animate-LoRA?taskId={taskId}`	Poll task status and retrieve results

All requests require your APIXO API key:

Authorization: Bearer YOUR_API_KEY

Submit requests also require:

Content-Type: application/json

Copy-paste async quickstart

curl -X POST "https://api.apixo.ai/api/v1/generateTask/wan-animate-LoRA" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "animate",
      "image_urls": [
        "https://example.com/character.png"
      ],
      "video_urls": [
        "https://example.com/motion.mp4"
      ],
      "prompt": "animate the character following the reference motion",
      "resolution": "720p",
      "seed": 12345
    }
  }'

The response contains a taskId. Save it and poll the status endpoint until state becomes success or failed.

Request body

{
  "request_type": "async",
  "input": {
    "mode": "animate",
    "image_urls": [
      "https://example.com/character.png"
    ],
    "video_urls": [
      "https://example.com/motion.mp4"
    ],
    "prompt": "keep the face stable and follow the reference motion naturally",
    "resolution": "480p",
    "seed": 42
  }
}

Parameters

string

default:"async"

Result delivery mode. Use async for polling with statusTask, or callback for webhook delivery.

string

Required when request_type is callback. Must be a public HTTPS URL that can receive the final task payload. See Webhooks.

object

required

Wan Animate LoRA input parameters.

Show properties

string

required

Generation mode. The only supported value is animate.

string[]

required

Source image URLs. Provide exactly 1 public HTTP/HTTPS image URL. The source image should be no larger than 50 MB.

string[]

required

Motion reference video URLs. Provide exactly 1 public HTTPS video URL. The video should be no larger than 200 MB. APIXO probes video_urls[0] to detect billing duration before submitting the task.

string

Optional prompt guidance. If provided, it must be a non-empty string.

string

default:"720p"

Output resolution. Supported values: 480p, 720p.

integer

Optional random seed from 0 through 2147483647.

Poll for result

curl -X GET "https://api.apixo.ai/api/v1/statusTask/wan-animate-LoRA?taskId=task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Processing response:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "processing"
  }
}

Success response:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://file.apixo.ai/video.mp4\"]}"
  }
}

After state becomes success, parse resultJson and read its resultUrls array.

Webhook callback mode

Use callback mode when your backend should receive the final result automatically instead of polling.

curl -X POST "https://api.apixo.ai/api/v1/generateTask/wan-animate-LoRA" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "callback",
    "callback_url": "https://your-server.com/webhooks/apixo",
    "input": {
      "mode": "animate",
      "image_urls": [
        "https://example.com/character.png"
      ],
      "video_urls": [
        "https://example.com/motion.mp4"
      ],
      "prompt": "animate the character following the reference motion",
      "resolution": "720p"
    }
  }'

See Webhooks for delivery requirements and retry behavior.

Billing

Wan Animate LoRA is billed per generated video second. The selected resolution determines the unit price, and billable duration is detected from video_urls[0].

Resolution	Billing input	APIXO price
`480p`	Detected reference video duration, minimum 5 seconds, billed to 3 decimal places	`$0.064 / second`
`720p`	Detected reference video duration, minimum 5 seconds, billed to 3 decimal places	`$0.132 / second`

If the reference video is shorter than 5 seconds, billing uses 5 seconds. Longer videos are billed by their detected duration. For current route and market comparison pricing, see Pricing.

Latency and polling

Actual latency may vary by reference video duration, resolution, queue load, and current route health.

Request shape	Typical generation time	Recommended first poll	Poll interval
Short `480p` animation	Varies with reference video duration and queue load	60s after task creation	5s-10s
Short `720p` animation	Varies with reference video duration and queue load	60s after task creation	5s-10s
Longer reference video	Varies with reference video duration and queue load	60s-120s after task creation	10s

Video generation can take several minutes. For production workloads, use callback mode to avoid frequent polling.

Errors and troubleshooting

Cause	What to check
Invalid mode	Use `mode: "animate"`
Invalid media shape	Provide exactly 1 `image_urls` item and exactly 1 `video_urls` item
Video URL cannot be probed	Use a direct public HTTPS video URL that supports range reads or full download
Invalid resolution	Use `480p` or `720p`
Invalid seed	Use an integer from `0` to `2147483647`
Upstream rate limit or timeout	Retry with backoff or switch to callback mode

See Error Codes for the full error reference.

Getting Started

Image Models

Video Models

Audio Models

Text & Utility Models

Wan Animate LoRA

Overview

Endpoint and authentication

Copy-paste async quickstart

Request body

Parameters

Poll for result

Webhook callback mode

Billing

Latency and polling

Errors and troubleshooting

​Overview

​Endpoint and authentication

​Copy-paste async quickstart

​Request body

​Parameters

​Poll for result

​Webhook callback mode

​Billing

​Latency and polling

​Errors and troubleshooting

​Related links

Overview

Endpoint and authentication

Copy-paste async quickstart

Request body

Parameters

Poll for result

Webhook callback mode

Billing

Latency and polling

Errors and troubleshooting

Related links