Video
Wan 2.2 Fast video
Wan 2.2 Fast — text-to-video.
Category: Create · wan-2-2-fast
How to use & limits
- Fast text-to-video, with an image-to-video option that animates a reference image.
- prompt: up to 800 characters.
- Resolution: 480p or 720p; aspect ratio 16:9 or 9:16.
- image_urls: 1 reference image.
Capabilities
What this model supports, straight from the schema — no pricing, no infrastructure detail.
| Capability | Value |
|---|---|
billing_unit Billing unit | per_video |
text_to_video Text-to-video | Yes |
image_to_video Image-to-video | Yes |
allowed_resolutions Allowed resolutions | 480p, 720p |
Parameters
Fields accepted in params (or first-class, where applicable) for POST /generations.
| Name | Label | Type | Required | Default | Options | Min / Max | Description |
|---|---|---|---|---|---|---|---|
aspect_ratio | Aspect ratio | select | Optional | 16:9 | 16:9 · 9:16 | — | Aspect ratio: 16:9 or 9:16. |
prompt | Prompt | textarea | Required | — | — | — | Video description, up to 800 characters. |
resolution | Resolution | select | Optional | 720p | 480p · 720p | — | Resolution: 480p or 720p. |
image_urls | Reference image(s) | multi_select | Optional | — | — | — – 1 | One reference image to animate (image-to-video). |
Example request
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-2-2-fast",
"prompt": "A cinematic panda walking through neon rain in Shanghai at night.",
"params": {
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "wan-2-2-fast",
"prompt": "A cinematic panda walking through neon rain in Shanghai at night.",
"params": {
"resolution": "480p",
"aspect_ratio": "16:9"
}
}),
});
const { data } = await res.json();
Example response
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "wan-2-2-fast",
"type": "video",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
The job's real cost is returned as credits_charged on the completed response — check GET /balance for the account balance.
Common errors for this job type:
insufficient_credits | Account balance can't cover the job cost. |
content_policy_violation | Prompt or media rejected by content policy. |
generation_timeout | The job exceeded the maximum processing time. |
rate_limited | Too many requests per minute. |
invalid_input | A required parameter is missing or outside the model's schema. |
generation_failed | Generic processing failure. |