LogoDocumentation Wan API
Accueil
X (Twitter)
Accueil

Prise en main

Vue d’ensembleGuide d’intégrationConsulter le soldeSupprimer une tâche

Modèles Wan

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Modèles Seedance

Seedance 2.5Seedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modèles d’image

Seedream 5.0 Pro
X (Twitter)

Seedream 5.0 Pro

Référence API Seedream 5.0 Pro : texte vers image, retouche par références, calques, PNG transparent, champs de requête, réponses et tarifs.

Seedream 5.0 Pro génère une image à partir d’un prompt, retouche ou combine jusqu’à 10 images de référence et sépare une image en une image de base et jusqu’à 16 calques transparents. La sortie est en 1K, 1.5K, 2K ou aux dimensions exactes en pixels. Détails du modèle et espace d’essai.

Connexion à Wan API

Utilisez https://api.wanapi.app comme URL de base de l’API. Créez une clé pour la famille de modèles Wan dans les paramètres des clés API et transmettez-la dans Authorization: Bearer YOUR_API_KEY. Conservez les clés sur votre serveur. L’espace d’essai utilise votre session sur le site et débite le même solde.

GET /v1/models répertorie les modèles accessibles à votre clé. Seedream 5.0 Pro utilise l’API OpenAI Images : POST /v1/images/generations avec du JSON, ou POST /v1/images/edits avec du JSON ou des fichiers importés en multipart. La requête renvoie sa réponse lorsque l’image est prête ; aucune tâche n’est à interroger.

ParamètreSeedream 5.0 Pro
Identifiant du modèlebytedance/seedream-5.0-pro
size1K, 1.5K, 2K (par défaut), ou WIDTHxHEIGHT avec 921 600–4 624 220 pixels et un format d’image de 1:16 à 16:1.
imageJusqu’à 10 images de référence.
SortieUne image par requête, ou une image de base et jusqu’à 16 calques avec layer_decomposition.

Générer une image

Définissez WAN_API_KEY avec votre clé sur le serveur. Envoyez la requête une seule fois ; la génération se termine généralement en moins d’une minute, mais prévoyez un délai d’attente côté client d’au moins quatre minutes.

curl https://api.wanapi.app/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "A minimalist magazine cover: a red fox in fresh snow at dawn, the bold serif title \"QUIET WILD\" across the top",
  "size": "1K"
}'

La réponse suit le format OpenAI Images. Les valeurs de l’exemple sont illustratives :

{
  "created": 1792022400,
  "data": [
    {
      "url": "https://cdn.example.com/image-1.jpg",
      "size": "1024x1024",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1
  }
}

Les URL des images restent disponibles pendant 30 jours. Stockez les fichiers vous-même si vous en avez besoin plus longtemps. Envoyez "response_format": "b64_json" pour recevoir aussi chaque image en Base64 dans b64_json.

Tarifs Seedream 5.0 Pro

Chaque image générée est facturée à l’image selon son nombre de pixels, à 30 % de moins que le tarif officiel : jusqu’à 2,61 millions de pixels (1K et 1.5K), le tarif inférieur s’applique ; au-delà, le tarif supérieur s’applique. La première image de référence est gratuite ; chaque image de référence supplémentaire ajoute le tarif de référence. Une requête rejetée avant la génération d’une image n’est pas facturée.

Tarifs actuelsUSD par image
Tarifs Seedream 5.0 Pro
Élément facturéTarif officielTarif Wan API
Image jusqu’à 2,61 MP (1K, 1.5K)0,045 $USIndisponible
Image de plus de 2,61 MP (2K)0,09 $USIndisponible
Décomposition en calques, toutes les images renvoyées jusqu’à 2,61 MP0,0225 $USIndisponible
Résultat en calques avec une image plus grande : chaque image jusqu’à 2,61 MP0,0225 $USIndisponible
Résultat en calques avec une image plus grande : chaque image de plus de 2,61 MP0,045 $USIndisponible
Chaque image de référence après la première0,003 $USIndisponible

Wan API propose les images Seedream 5.0 Pro, les références supplémentaires et la décomposition en calques en 1K ou 1.5K à 30 % de moins que le prix officiel par image. Un résultat en calques comprenant une image de plus de 2,61 MP est facturé au tarif officiel.

La décomposition en calques facture l’image de base et chaque calque renvoyé. Si toutes les images renvoyées font au maximum 2,61 MP, chacune est facturée au tarif réduit des calques ; si une image est plus grande, chaque image est facturée au tarif officiel des calques correspondant à ses propres dimensions. L’estimation couvre le maximum de 17 images.

Tarifs officiels : BytePlus ModelArk. Vérifié le 2026-10-23.

La décomposition en calques facture l’image de base et chaque calque renvoyé. Si toutes les images renvoyées font au maximum 2,61 millions de pixels, chacune coûte 30 % de moins que le tarif officiel des calques. Si une image renvoyée est plus grande, ce qui est toujours le cas en 2K, chaque image est facturée au tarif officiel des calques correspondant à ses propres dimensions. Votre solde doit couvrir le maximum de 17 images ; vous ne payez que les images renvoyées.

Champs de requête

Envoyez un objet JSON. model est obligatoire ; prompt est obligatoire sauf si layer_decomposition vaut true. Les champs inconnus sont rejetés.

ChampTypeContrat
modelchaîneObligatoire : bytedance/seedream-5.0-pro.
promptchaîneCe qu’il faut générer ou les éléments à séparer lors de la décomposition en calques. Prend en charge l’anglais, le chinois et d’autres langues ; pour obtenir les meilleurs résultats, restez en dessous d’environ 600 mots en anglais.
imagechaîne ou tableau de chaînesJusqu’à 10 images de référence sous forme d’URL HTTP(S) ou de data:image/<format>;base64,... avec un format en minuscules. Formats : JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF ; jusqu’à 30 MB chacune ; format d’image de 1:16 à 16:1.
sizechaîneGénération d’images : 1K, 1.5K, 2K (par défaut) ou WIDTHxHEIGHT. Décomposition en calques : 1K, 1.5K, 2K ou auto (par défaut).
layer_decompositionbooléenfalse par défaut. true sépare exactement une image PNG ou JPEG en une image de base et jusqu’à 16 calques.
optimize_prompt_optionsobjet{"mode": "standard"} (par défaut) ou {"mode": "fast"}. Le mode rapide réduit le temps de génération avec une qualité légèrement inférieure.
output_formatchaînejpeg (par défaut) ou png. Pour la décomposition en calques, définit le format de l’image de base ; les calques sont toujours en PNG.
backgroundchaîneopaque (par défaut) ou transparent. Le mode transparent nécessite exactement une image d’entrée possédant un canal alpha et une sortie PNG ; il ne peut pas être combiné avec la décomposition en calques.
watermarkbooléentrue par défaut : ajoute une petite mention de génération par IA. Envoyez false pour la supprimer.
nsfw_checkerbooléentrue par défaut maintient la vérification du contenu activée. false envoie la requête sans cette vérification ; le prix reste identique.
response_formatchaîneurl (par défaut) ou b64_json.
nentierFacultatif ; doit valoir 1.

stream, sequential_image_generation, tools, seed, guidance_scale et mask ne sont pas pris en charge par ce modèle et sont rejetés.

Retoucher et combiner des images de référence

Transmettez une image avec une instruction de retouche, ou plusieurs images à combiner :

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Place the perfume bottle from image 1 on the marble table from image 2, soft window light",
  "image": [
    "https://example.com/bottle.png",
    "https://example.com/table.jpg"
  ],
  "size": "2K",
  "output_format": "png"
}

POST /v1/images/edits accepte les mêmes champs. En multipart, importez les fichiers dans les champs image ou image[] et envoyez optimize_prompt_options sous forme de chaîne JSON.

Décomposition en calques

{
  "model": "bytedance/seedream-5.0-pro",
  "prompt": "Separate the title text, the parrot and the background",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "size": "2K"
}

La réponse présente d’abord l’image de base. Chaque calque ajoute son ordre de superposition, sa position et sa description :

{
  "created": 1792022400,
  "data": [
    { "url": "https://cdn.example.com/image-1.jpg", "size": "2048x2048", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://cdn.example.com/image-2.png",
      "size": "1273x265",
      "output_format": "png",
      "z_index": 1,
      "bounding_box": { "absolute": [383, 120, 1655, 384], "normalized": [187, 59, 808, 188] },
      "name": "Title text",
      "description": "Yellow serif title text"
    }
  ],
  "usage": { "input_images": 1, "generated_images": 2 }
}

Si un calque échoue, toute la requête échoue. Si le prompt demande plus de calques que la limite, le contenu de certains calques peut être omis.

Erreurs

Les erreurs utilisent l’enveloppe d’erreur OpenAI {"error": {"message", "type", "code"}}.

HTTPcodeSignification
400invalid_request ou un message de validationUn champ ou une combinaison n’est pas pris en charge. Corrigez la requête ; rien n’a été facturé.
400content_policy_violationLe prompt, une image d’entrée ou la sortie a été rejeté par la politique de contenu. Rien n’a été facturé.
402quota insuffisantAjoutez des fonds avant un nouvel envoi.
429rate_limitedTrop de requêtes. Réessayez plus tard.
502submission_unknownLe résultat n’a pas été reçu et la requête n’a pas été facturée. Vérifiez vos journaux d’utilisation avant de l’envoyer à nouveau.
503upstream_unavailableLa génération d’images est temporairement indisponible ; la requête n’a pas été facturée.

Ne relancez jamais automatiquement une requête après un dépassement de délai sans avoir d’abord vérifié vos journaux d’utilisation.

Seedance 2.0 Mini

Référence API Seedance 2.0 Mini : génération vidéo, images et références, exemples de requêtes, suivi des tâches, téléchargements et tarifs.

Sommaire

Connexion à Wan APIGénérer une imageTarifs Seedream 5.0 ProChamps de requêteRetoucher et combiner des images de référenceDécomposition en calquesErreurs