WAN3 Developer Platform

Une API pour créer images et vidéos.

Découvrez les modèles, importez vos médias en sécurité, envoyez des tâches idempotentes et lisez les résultats depuis le stockage WAN3.

/models

Découverte des modèles

/uploads

Médias propriétaires vérifiés

/generations

Tâches image et vidéo unifiées

Votre première génération

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

Télécharger les Skills image et vidéo

Les Skills appellent WAN3 avec votre clé API. Les identifiants internes restent côté serveur.

Télécharger le ZIP Skills 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.

Texte vers image

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())

Import de médias propriétaires

# 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

Suivi de tâche

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

Contrat d’erreur stable

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

Les clés API ne sont affichées qu’une fois et restent côté serveur. Réutilisez la même Idempotency-Key lors des nouvelles tentatives et créez-en une nouvelle seulement pour une nouvelle tâche. Modèles via GET /models, usage via GET /usage.