Text to Video
Generate a video with sound from a prompt alone, in either variant (Wan 3.0 text_to_video).
Wan 3.0 generates a video from a prompt alone, with either variant.
Create a task
https://api.nanoapi.ai/v1/tasksUse the shared create endpoint with model: "wan-3.0".
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <API key>, see Authentication. |
Content-Type | Yes | application/json |
Idempotency-Key | No | A unique string for every new task, ideally a UUID (1–255 characters). See Preventing duplicate tasks. |
Body
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | wan-3.0 |
variant | string | Yes | standard or prime, see Variants. Sets the price. |
mode | string | Yes | text_to_video |
prompt | string | Yes | What the video shows, at most 8000 characters. Best written in English. |
resolution | string | Yes | 480p, 720p or 1080p. Sets the price. |
aspect_ratio | string | Yes | 16:9, 9:16, 1:1, 4:3 or 3:4 (auto isn't accepted). |
duration | integer | Yes | Output length in seconds, 2–30. Billed per second, see Pricing. |
generate_audio | boolean | No | Whether the output has sound, default true. Doesn't affect the price. |
enable_thinking | boolean | No | true has the model reason about the prompt before generating: closer to your description, but slower. Default false. |
webhook_url | string | No | Notified when the task succeeds or fails: https, up to 2048 characters, not a private, loopback or reserved address. See Webhooks. |
standard, 720p, 16:9, 5 seconds:
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan-3.0",
"variant": "standard",
"mode": "text_to_video",
"prompt": "A golden retriever running along a beach at sunset, cinematic tracking shot",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5
}'Response: 200 OK, the new task (fields). Keep data.id to get the result; the task can still fail, see Errors.
{
"code": 200,
"message": "success",
"data": {
"object": "task",
"id": "tk_01jbq5w8m2c4x7b0n3q6t9e1r5",
"model": "wan-3.0",
"status": "queued",
"error": null,
"created_at": "2026-11-11T08:30:00Z"
}
}Pricing
cost = duration × price per second of the variant and resolutionLoading the current prices…
Billed seconds are the duration you ask for; sound in the output (generate_audio) and enable_thinking don't change the price. Current prices: GET /v1/products (the prices rows of the variant). The task's billing.frozen is the amount that counts; freezing and charging: Billing. Every variant's prices: Wan 3.0 → Pricing.
Errors
See Wan 3.0 → Errors. This mode's parameter rules are in the table above.