WAN3 Developer Platform

Una API per creare immagini e video.

Scopri i modelli, importa media di tua proprietà, invia attività idempotenti e leggi i risultati dallo storage WAN3.

/models

Scoperta modelli runtime

/uploads

Media di proprietà verificati

/generations

Attività immagine e video unificate

La tua prima generazione

curl https://wan3.net/api/v1/generations \
  -H "Authorization: Bearer $WAN3_API_KEY" \
  -H "Idempotency-Key: video-job-001" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3","input":{"type":"text-to-video","workflow":"t2v","prompt":"A paper dragon crossing an orange-lit city","duration":5,"resolution":"720p","aspect_ratio":"16:9"}}'

OpenAPI 3.1 MarkdownIdempotency-Key requiredNo browser CORS keys

WAN3 Agent Skills · v1.0.0

Scarica gli Skills per immagini e video

Gli Skills chiamano WAN3 con la tua chiave API. Le credenziali interne restano sul server.

Scarica Skills ZIP SHA-256

unzip wan3-agent-skills-v1.0.0.zip
export WAN3_API_KEY=wan3_live_...
# Copy wan3-image-generation or wan3-video-generation into your agent's skills directory.

Testo in immagine

curl https://wan3.net/api/v1/generations \
  -H "Authorization: Bearer $WAN3_API_KEY" \
  -H "Idempotency-Key: image-job-001" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana","input":{"type":"text-to-image","prompt":"A ceramic fox in a quiet studio","aspect_ratio":"1:1"}}'

Node.js

const response = await fetch("https://wan3.net/api/v1/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.WAN3_API_KEY}`,
    "Idempotency-Key": "video-job-001",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan3",
    input: { type: "text-to-video", workflow: "t2v", prompt: "A paper dragon crossing a city", duration: 5, resolution: "720p" },
  }),
});
console.log(await response.json());

Python

import os, requests

response = requests.post(
    "https://wan3.net/api/v1/generations",
    headers={
        "Authorization": f"Bearer {os.environ['WAN3_API_KEY']}",
        "Idempotency-Key": "image-job-001",
    },
    json={"model": "nano-banana", "input": {"type": "text-to-image", "prompt": "A ceramic fox"}},
    timeout=30,
)
print(response.json())

Caricamento media di proprietà

# 1. Reserve: POST /api/v1/uploads with file_name, file_type, file_size
# 2. PUT bytes to data.upload_url with every data.required_headers value
# 3. Complete: POST /api/v1/uploads/{reservation_id}/complete
# 4. Pass the returned opaque media id in input.media_ids

Polling

curl https://wan3.net/api/v1/generations/{generation_id} \
  -H "Authorization: Bearer $WAN3_API_KEY"

Contratto errori stabile

code	HTTP	meaning
invalid_request	400	Request fields or owned media are invalid
unauthorized	401	API key is invalid, expired, or revoked
insufficient_credits	402	Account balance cannot fund the task
forbidden	403	The key does not have the required scope
not_found	404	The owned generation or media was not found
idempotency_conflict	409	The key was reused with another public request
rate_limited	429	Retry after the Retry-After interval
provider_rejected	502	The task was rejected and exposes no upstream details
service_busy	503	Retry safely with the same Idempotency-Key

Le chiavi API vengono mostrate una volta e restano sul server. Riusa la stessa Idempotency-Key nei tentativi di rete e creane una nuova solo per un nuovo task. Modelli con GET /models, utilizzo con GET /usage.