Overview

Wan 2.5 is optimised for short-form, vertical creatives. It generates 9:16, 4:5, or 1:1 clips in as little as twelve seconds and includes metadata for copy safe areas, subtitle timing, and predicted engagement.

Quick Start

curl -X POST "https://api.transendai.net/v1/videos/wan2.5/generation" \
  -H "Authorization: Bearer $TRANSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Vertical ad for iced cold brew with kinetic typography",
    "aspect_ratio": "9:16",
    "brand_palette": ["#FFD166", "#073B4C"],
    "variants": 3,
    "cta_text": "Tap to order"
  }'

Arguments

Field	Type	Description
`prompt`	string	Creative direction for the entire clip.
`aspect_ratio`	string	`9:16`, `4:5`, or `1:1`. Defaults to `9:16`.
`brand_palette`	array	Hex colors applied to typography and accents.
`variants`	number	Number of variants (1–6).
`cta_text`	string	Optional CTA overlay text.

Response Format

{
  "task_id": "task_wan_47d",
  "status": "succeeded",
  "result": {
    "variants": [
      {
        "variant_id": "v1",
        "video_url": "https://edge.transendai.net/task_wan_47d/v1.mp4",
        "safe_area": { "top": 120, "bottom": 160 },
        "subtitles": [{ "text": "Tap to order", "start": 12.4, "end": 14.0 }],
        "score": { "attention": 0.82, "readability": 0.9 }
      }
    ]
  }
}

Use the safe_area values (pixels) to place overlays without clipping on social feeds.

Batch Reuse

Replay a winning variant with new copy by calling the variants endpoint:

curl -X POST "https://api.transendai.net/v1/videos/wan2.5/variants" \
  -H "Authorization: Bearer $TRANSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_variant": "v1",
    "cta_text": "Order now",
    "subtitle_style": "bold"
  }'

Rate Limits

Default quotas allow 20 concurrent Wan tasks per workspace and 3 requests per second. Growth and enterprise plans can raise both the concurrency and RPM limits.

Error Reference

Code	Meaning	Resolution
`400`	Unsupported aspect ratio or invalid palette.	Use supported ratios and hex colors (e.g., `#FFEE00`).
`422`	Variants exceed limit.	Set `variants` to 6 or fewer per call.
`503`	Regional GPU congestion.	Retry with exponential backoff or target a different region.

Production Tips

Always inspect score metrics to prune low-performing variants before launching campaigns.
Use the metadata to align copy changes across CRM, push, and social channels.
Cache generated clips in your own CDN if long-term hosting is required.

Wan 2.5 landing page
Support for quota upgrades.

Wan 2.5 API