WAN Reference to Video API

Alibaba WAN reference-to-video. Up to 5 image/video references with multi-shot support. Integrate this model via REST with endpoint docs, parameters, and code examples.

Video Generation

Img2Vid

Credit Cost

4 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-reference-to-video/run

LLM.txt

AI-Ready

For AI assistants

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

/llm/wan-reference-to-video.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
`prompt` required	string	Text description of the video to generate	-
`reference_urls` required	array	Reference image or video URLs (1-5). items: url min items: 1 \| max items: 5	-
`model`	enum	WAN reference-to-video variant. `wan2.7-r2vwan2.6-r2vwan2.6-r2v-flash`	`wan2.7-r2v`
`duration` required	integer	Video duration in seconds (2-10). min: 2 \| max: 10	-
`resolution`	enum	Output resolution (720p or 1080p; trailing "p" optional). `7201080`	`720`
`aspect_ratio`	enum	Output aspect ratio. `16:99:161:14:33:4`	-
`shot_type`	enum	Single shot or multi-shot composition. `singlemulti`	`single`
`negative_prompt`	string	What to avoid in the video.	-
`watermark`	boolean	Whether to render a provider watermark.	`false`
`seed`	integer	Random seed for reproducibility (0–2147483647). min: 0 \| max: 2147483647	-

Supported Aspect Ratios

16:9

9:16

1:1

4:3

3:4

Example Outputs

Real outputs generated by this model

View Details

a thrilling action sequence of a woman trying to find her favorite candy. The candy wrapper is purple with a pixelated dragon and reads "Pixel Dojo". The woman says "Gotta have that pixel dojo candy. with over 60 ai tools, it's basically zero calories."

0 credits

Code Examples

Copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/wan-reference-to-video/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic shot of ocean waves at sunset",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 4,
  "creditsRemaining": 95,
  "expiresAt": "2025-01-23T12:00:00Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 4,
  "expiresAt": "2025-01-23T12:00:00Z"
}

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