Wan 3.0 Prime API

Wan 3.0 Prime: video from text, images, video or audio.

720p output
2 to 30 second clips
With a reference video, up to 15 seconds of input

Pricing
Resolution	Text, images or video
720p	Text, images or video28 Credits/s ($0.14/s)

With video input, both the input and output seconds are billed.

Full pricing ↓

Prompt

Duration in seconds

Between 2 and 30 seconds. With reference videos, input plus output is at most 30 seconds.

Auto

The model picks the length, up to 30 s. You pay for the length it makes.

Aspect ratio

Auto matches the shape of your input media.

Generate audio

Adds a soundtrack.

Fixed for this input: 720P

Advanced

Watermark

Seed

The same seed and settings give a similar result. Leave it empty for a random seed.

Checking whether you’re signed in.

Your result appears here

Pricing

Prices as of 2026-11-09

Tier	Price
720p	28 Credits/s ($0.14/s)^{Note 11}2–30 s
720p with video input 720p-video	28 Credits/s ($0.14/s)^{Notes 2, 32, 3}2–30 s

Holds Credits for up to 30 seconds and charges the actual length.
The rate applies to input and output seconds.
Holds Credits for up to 30 seconds of output plus up to 15 seconds of input, and charges the actual length.

1 Credit ≈ $0.005. At the standard pack price. Larger packs include bonus Credits, so each Credit costs less.

Delivery and billing

Output: Finished files are listed in the task result with an asset ID and type for each.
Download: Files are kept for 7 days and downloaded through short-lived signed links. You can delete them any time.
Billing: Credits are held when a task is accepted and charged on delivery. If generation fails, or nothing is delivered within 24 hours, the held Credits are released in full.
Notifications: Poll the task by ID, or use signed webhooks and deduplicate by event_id.

How is it billed?

The same per-second rate with or without a reference video. Reference-video seconds are billed too, in addition to the output seconds (5 s of output plus 10 s of reference video bills 15 s).

Do failed generations cost anything?

No. If generation fails, or nothing is delivered within 24 hours of acceptance, the held Credits are released in full.

API reference

Create the task once, then poll it by its ID. Full script with upload and download · API reference

Request

API=https://api.vizoapi.com/v1
AUTH="Authorization: Bearer $VIZO_API_KEY"

# Create the task once and keep its ID.
ID=$(curl -fsS $API/generations -H "$AUTH" -H "Content-Type: application/json" \
  -d '{
  "model": "wan-3-0-prime",
  "input": {
    "prompt": "A slow dolly shot through a rainy neon street",
    "parameters": {
      "ratio": "16:9",
      "duration": 5
    }
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}' | jq -r .id)

# Poll until the task closes, then read its status and result.
until curl -fsS $API/generations/$ID -H "$AUTH" | jq -e '.closed_at != null' > /dev/null; do sleep 5; done
curl -fsS $API/generations/$ID -H "$AUTH" | jq '{status, result}'

All fields

Send these fields in input. A field the table does not list is refused with HTTP 422 invalid_input.

Send a prompt, media or both.
first_frame and last_frame (at most one each) cannot be combined with reference items, file or link.
Reference videos total at most 15 seconds, reference audios at most 15 seconds, and reference video input plus output length at most 30 seconds.

Request parameters
Field	Description
`prompt`string	Required: at least one of `prompt` or `media` Up to 20000 characters. Cite media in order, for example image 1 or video 1. Send a prompt, media or both. At most 20,000 characters
`media`array of objects	Required: at least one of `prompt` or `media` first_frame and last_frame (at most 1 each) cannot be combined with reference items, file or link. Up to 10 reference images, 5 reference videos (15 seconds in total) and 5 reference audios; at most one file or one link, not both. At least 1 items · At most 22 items
`media[].type`stringRequired	Media kind. Allowed values`first_framelast_framereference_imagereference_videoreference_audiofilelink`
`media[].url`stringRequired	An https URL or an uploaded asset id (ast_...). file and link take a public https URL only. At most 4000 characters · Pattern`^(https://\|ast_)`
`parameters`objectRequired
`parameters.resolution`stringOptional	Output resolution. Only 720P. Only `720P` Default `720P`
`parameters.ratio`stringOptional	Output aspect ratio. Defaults to adaptive. Allowed values`adaptive16:94:31:13:49:16` Default `adaptive`
`parameters.duration`anyRequired	Output seconds, 2 to 30, or -1 for automatic length. Holds the maximum; known input reduces it to fit the 30-second total. 2 to 30, or `-1`
`parameters.audio`booleanOptional	Adds a soundtrack. Defaults to true. Default `true`
`parameters.seed`integerOptional	Random seed. Minimum 0 · Maximum 2,147,483,647
`parameters.watermark`booleanOptional	Add a visible watermark. Defaults to false; the tier price is unchanged. Default `false`

Full example request and response

A complete create request, the 202 answer and the task once it has succeeded. This input selects the 720p tier at 28 Credits per second. For 5 seconds the API holds 140.000 Credits.

Request

{
  "model": "wan-3-0-prime",
  "input": {
    "prompt": "A paper boat drifting on a pond at dawn, slow dolly in",
    "parameters": {
      "ratio": "16:9",
      "duration": 5
    }
  },
  "metadata": {
    "client_reference": "my-unique-reference-1"
  }
}

202 Accepted

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "wan-3-0-prime",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "processing",
  "execution_status": "processing",
  "delivery_status": "pending",
  "billing_status": "pending",
  "version": 1,
  "price": {
    "unit": "credit",
    "estimated": "140.000",
    "reserved": "0.000",
    "charged": "0.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": null,
  "error": null,
  "result": null
}

200 Succeeded

{
  "id": "gen_01JD8Z5QW3XR",
  "model": "wan-3-0-prime",
  "source": "api",
  "created_at": "2026-11-08T09:00:00Z",
  "customer_resolution_deadline": "2026-11-09T09:00:00Z",
  "late_result_available": false,
  "metadata": {
    "client_reference": "my-unique-reference-1"
  },
  "status": "succeeded",
  "execution_status": "succeeded",
  "delivery_status": "ready",
  "billing_status": "settled",
  "version": 4,
  "price": {
    "unit": "credit",
    "estimated": "140.000",
    "reserved": "0.000",
    "charged": "140.000",
    "refunded": "0.000"
  },
  "allowed_actions": [],
  "closed_at": "2026-11-08T09:01:31Z",
  "error": null,
  "result": {
    "asset_id": "ast_01JD8Z9M2C4V",
    "outputs": [
      {
        "index": 0,
        "asset_id": "ast_01JD8Z9M2C4V",
        "content_type": "video/mp4"
      }
    ]
  }
}

Full API reference for Wan 3.0 Prime

Pricing

Delivery and billing

API reference

Similar models