Wan 3.0 Video Prime

For 2K or 4K, use the same model id. Document and web page references (reference_file_urls / reference_link_urls) are unavailable at these resolutions.

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video-prime",
    "prompt": "A lighthouse keeper climbing a spiral staircase at dawn",
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "duration": 10
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "wan3.0-video-prime",
        "prompt": "A lighthouse keeper climbing a spiral staircase at dawn",
        "resolution": "720P",
        "aspect_ratio": "16:9",
        "duration": 10,
    },
)
task_id = resp.json()["id"]

const resp = await fetch('https://reapi.ai/api/v1/videos/generations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'wan3.0-video-prime',
    prompt: 'A lighthouse keeper climbing a spiral staircase at dawn',
    resolution: '720P',
    aspect_ratio: '16:9',
    duration: 10,
  }),
});
const { id } = await resp.json();

body := strings.NewReader(`{
  "model": "wan3.0-video-prime",
  "prompt": "A lighthouse keeper climbing a spiral staircase at dawn",
  "resolution": "720P",
  "aspect_ratio": "16:9",
  "duration": 10
}`)

req, _ := http.NewRequest("POST", "https://reapi.ai/api/v1/videos/generations", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)

Authentication

Every request needs an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create one in API keys.

Endpoint

POST https://reapi.ai/api/v1/videos/generations

Generation is asynchronous. The response carries a task id; poll GET /api/v1/tasks/{id} until status settles.

Modes

There is no mode field — the model picks the mode from which media fields are present. The two media families are mutually exclusive and a request that mixes them is rejected.

In reference mode, address your material from the prompt as Image1, Video1, Audio1 and so on, numbered by position within each array.

Request body

Content filter

Ordinary API keys always use the NSFW channel. Both content_filter and nsfw_checker are ignored, so sending true does not enable filtering.

Administrator-owned API keys can set content_filter to a boolean:

For administrator keys, the legacy boolean nsfw_checker remains accepted; content_filter takes precedence when both are present. Invalid non-boolean values are rejected. 2K and 4K with filtering enabled are rejected before credits are charged. The effective setting is preserved on every fallback, and the filter choice does not change the public price.

Administrator key permissions are cached for up to 5 minutes. Role changes may take that long to affect requests.

Playground generation is disabled. Use Authorization: Bearer YOUR_API_KEY; a website session cookie cannot submit this model, even for administrators.

Response envelope

Submitting returns a task id:

{ "id": "task_01k9s419324drezfbwnsvxyr6h", "status": "processing" }

Poll GET /api/v1/tasks/{id}. A completed task looks like:

{
  "id": "task_01k9s419324drezfbwnsvxyr6h",
  "model": "wan3.0-video-prime",
  "status": "completed",
  "created_at": 1762853430,
  "output": {
    "video_urls": [
      "https://cdn.reapi.ai/media/tasks/01k9s419324drezfbwnsvxyr6h/0.mp4"
    ]
  },
  "usage": { "credits": 1386 },
  "error": null
}

usage.credits is what the task actually cost once settled — see Tasks.

Pricing

Billing has two dimensions: billable seconds × resolution.

Neither the mode nor the audio track changes the rate — a document-to-video request costs the same per second as a text-to-video one at the same resolution, with or without sound. Current per-second rates for each resolution are on the model page.

billable_seconds = reference_video_seconds + duration
credits          = ceil(public_per_second_usd × billable_seconds × 1000)

1 credit = $0.001 USD. Use the public rate at its billing precision; the model page rounds rates for display. The task estimate and settled usage.credits provide the charge for a specific request.

Three things to know before you send a request:

• Omitting resolution bills at 1080P because that is the model's own default.
• Reference video is billable on top of duration. Each clip in reference_video_urls is processed as well as generated, so its own length is charged too. reAPI measures the clips server-side at submit time, and their combined length with duration is capped at 30 seconds — a 6-second clip with duration: 8 bills 14 seconds. Reference images, audio, documents and web pages carry no billable length. A clip reAPI cannot read is rejected rather than billed as zero.
• duration: -1 reserves the 30-second ceiling. The final length is not knowable at submit time, so the hold is taken at the maximum. Pass an explicit duration when cost matters.

Failed tasks are refunded automatically.

Errors

Full catalog: Errors.

Tips

• Iterate at 480P and switch to 1080P only for the final render — the rate scales with the tier and the framing does not change.
• Reference images hold characters and wardrobe across a long take. Name them positionally in the prompt (Image1, Image2) rather than describing them again in prose.
• With reference video, remember input seconds count against the 30-second budget: a 10-second reference leaves 20 seconds of output.
• Write prompts as a shot list with explicit time ranges. The model follows timed beats more reliably than a single paragraph of description.
• Pick the standard Wan 3.0 tier when turnaround is not the constraint. It has a lower rate but different request fields; adapt the payload using the standard model documentation.

Related

• Wan 3.0 — the standard tier of the same model
• Tasks — polling, usage.credits, and task lifecycle
• Errors — full error code catalog