WAN 2.2 Replace API

WAN 2.2 character replacement. Swap a character in a source video while preserving scene and motion. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Video Generation

Img2Vid

Credit Cost

10 credits

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/wan-2.2-replace/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/wan-2.2-replace.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`video` required	url	URL of the source video whose character you want to replace.	-
`character_image` required	url	URL of the replacement character image. Face/body that will be swapped into the source video.	-
`video_duration` required	integer	Duration of the output video in seconds. Must match or be less than the source video length. min: 1 \| max: 15	`5`
`resolution`	enum	Output resolution tier. `480720`	`480`
`refert_num`	integer	Number of reference frames to use from the character image (advanced). min: 1 \| max: 10	-
`frames_per_second`	integer	Target frames per second for the output video. min: 8 \| max: 30	-
`go_fast`	boolean	Trade some quality for faster generation.	`false`
`merge_audio`	boolean	Keep the audio track from the source video.	`true`
`seed`	integer	Random seed for reproducibility.	-

Example Outputs

Real outputs generated by this model

View Details

0 credits

Code Examples

Character replace — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/wan-2.2-replace/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://...",
    "character_image": "https://...",
    "video_duration": 5
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 10,
  "creditsRemaining": 95,
  "expiresAt": "2026-07-18T05:19:12Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 10,
  "expiresAt": "2026-07-18T05:19:12Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits