# Wan3.0 Video

Model id on AIHubMix: `wan3.0-video`
Create an API key: https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms

> Wan 3.0 (Tongyi Wanxiang 3.0) is an integrated video generation and editing model launched by Alibaba’s Tongyi Lab. It is suitable for scenarios such as advertising, e-commerce, short films, character animation, video editing, and document-to-video. Its advantages include native support for videos up to 30 seconds long and the unified handling of reference content such as text, images, audio, video, documents, spreadsheets, presentations, and web pages, delivering more realistic visuals and audio, stable character consistency, and capabilities for referencing, editing, replication, and driving. Compared with Wan 2.7, which split text-to-video, image-to-video, reference generation, and editing across multiple models, Wan 3.0 integrates these capabilities into a single model, making the creative workflow more unified and flexible.

- Developer: Qwen
- Input modalities: image, text, audio, video
- Pricing: per-generation — see https://aihubmix.com/model/wan3.0-video

## Endpoints (base URL: https://aihubmix.com)

- `POST /ai/v1/videos` — video generation (`Authorization: Bearer $AIHUBMIX_API_KEY`); async — poll `GET /ai/v1/videos/{id}` until a terminal state
- `POST /v1/videos` — video generation (`Authorization: Bearer $AIHUBMIX_API_KEY`); async — poll `GET /v1/videos/{id}` until a terminal state

## Example

```bash
curl -s https://aihubmix.com/ai/v1/videos \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video","prompt":"<your prompt>"}'
```

The response contains a task id — poll `GET https://aihubmix.com/ai/v1/videos/<task_id>` until `status` is terminal, then read the output URL(s). Full parameter list: see the schema link below. Generation costs real money — check the price on the model page first.

## Parameters (video endpoint)

| name | type | required | default | enum |
|---|---|---|---|---|
| `aspect_ratio` | string,null | no | "adaptive" | 16:9, 9:16, 1:1, 4:3, 3:4, null, … |
| `duration` | integer|null | no | 5 | -1, 2, 3, 4, 5, 6, … |
| `extra` | object,null | no |  |  |
| `generate_audio` | boolean,null | no | "ture" |  |
| `model` | string | yes |  |  |
| `prompt` | string | yes |  |  |
| `resolution` | string,null | no | "1080p" | 720p, 1080p, null, 480p |
| `seed` | integer,null | no |  |  |
| `webhook_url` | string,null | no |  |  |

Always-current parameter schema (authoritative, no auth):

```bash
curl -s https://aihubmix.com/call/schema/models/wan3.0-video/endpoints
```

Output URLs are short-lived (roughly 30 minutes) and are downloaded with the same `Authorization: Bearer` header — fetch them promptly and store the content yourself.

## Errors

Error responses carry a `tid` (trace id) — include it when contacting support. Reference: https://docs.aihubmix.com/en/FAQs/HTTP-Codes.md

- 400 — parameter error; most are passed through from the upstream provider (media: `prompt_missing`, `size_not_supported`, `n_not_within_range`, …)
- 401 — missing `Authorization` header, or the key is invalid/expired
- 403 — `insufficient_user_quota` (top up at https://console.aihubmix.com/?utm_source=llms-agent&utm_medium=model-llms), account suspended, or this key is not allowed to use this model
- 429 — rate limited; back off and retry
- 503 — no channel can serve the request (check the model id and your access), or the upstream provider is throttling; retry later

## More

- Machine-readable endpoint schema (no auth): https://aihubmix.com/call/schema/models/wan3.0-video/endpoints
- Async task guide: https://docs.aihubmix.com/en/api/async-tasks.md
- Model page: https://aihubmix.com/model/wan3.0-video
- Try in browser: https://playground.aihubmix.com/?model=wan3.0-video
- Compare with another model (human-facing, side-by-side specs and pricing): https://aihubmix.com/compare — pick this model and a peer there; published pairs are listed in https://aihubmix.com/sitemap-compare.xml, unpublished pairs 404 so do not compose the path by hand
- Generate runnable code programmatically: npm `@aihubmix/codegen` — the generator behind the Playground's "Get Code" (4 protocols × 7 languages, media endpoints included); the body it builds is the exact wire body the Playground sends, so generated snippets and real requests cannot diverge. `@aihubmix/model-schema` (npm) translates the parameter schema above into codegen input
- Site index for agents: https://aihubmix.com/llms.txt · Onboarding: https://aihubmix.com/agents.md

---

Canonical version of this document: https://aihubmix.com/model/wan3.0-video/llms.txt