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.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

Modèles d’image

Seedream 5.0 ProAPI Seedream 5.5

Modèles de langage

API ClaudeClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2API GPTGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

API Seedream 5.5

Générez, retouchez ou séparez en calques avec Seedream 5.5. Paramètres de requête, tâches asynchrones, métadonnées d’image et tarifs actuels par image.

Seedream 5.5 génère une image à partir de texte ou de 10 images de référence maximum. La décomposition en calques prend une image et renvoie une image de base et des calques transparents, avec un résultat facultatif de reconnaissance de texte imprimé.

Essayer l’espace d’essai · JSON OpenAPI · Tutoriel d’intégration

Authentification et points de terminaison

Utilisez votre clé Wan API comme jeton Bearer. Une clé donne accès à tous les modèles et groupes disponibles ; vous ne sélectionnez pas de groupe sur la clé.

MéthodeURLObjectif
POSThttps://api.wanapi.app/seedream55/v1/images/generationsEnvoyer une tâche d’image
GEThttps://api.wanapi.app/seedream55/v1/tasks/{id}Consulter cette tâche

L’identifiant du modèle est seedream-5-5. Ces points de terminaison sont asynchrones. Envoyez une seule fois, enregistrez l’identifiant de tâche et interrogez-le jusqu’à completed ou failed. Une réponse réseau incertaine n’autorise pas un nouvel envoi.

Générer une image

curl https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-5",
    "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
    "size": "1K"
  }'

Une requête acceptée renvoie une tâche plutôt que les octets de l’image :

{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
  -H "Authorization: Bearer $WAN_API_KEY"

Interrogez le même identifiant toutes les quelques secondes. Conservez-le si votre application cesse d’attendre, afin de reprendre plus tard. Les identifiants de tâche et horodatages de ce guide sont illustratifs.

Paramètres

ParamètreTypeValeur par défautRègles
modelchaîneobligatoireseedream-5-5
promptchaîneobligatoire pour la générationFacultatif pour la décomposition en calques.
imageURL ou tableau d’URLaucuneJusqu’à 10 références ; exactement une pour les calques. Chaque référence est facturée.
sizechaîne2K, ou auto pour les calquesVoir les règles de dimensions ci-dessous.
output_formatchaînepngpng ou jpeg. Pour les calques, contrôle uniquement l’image de base.
backgroundchaîneautoauto, opaque, transparent. La transparence nécessite PNG. Omettez entièrement ce champ en mode calques.
layer_decompositionbooléenfalseSéparer une référence en une image de base et des calques PNG transparents.
layer_decomposition_options.max_imagesentier30Plafond total de 2–100 images, base comprise. Uniquement en mode calques.
layer_decomposition_options.text_recognitionbooléenfalseDemander les métadonnées de texte imprimé dans les calques. Uniquement en mode calques.
optimize_prompt_options.modechaînestandardLe seul mode pris en charge est standard.
watermarkbooléenfalseDemander un filigrane indiquant un contenu généré par IA.
content_filterbooléentrueL’API client accepte false. Dans l’espace d’essai, seuls les administrateurs peuvent le désactiver.

Les paramètres n, seed, stream, resolution, aspect_ratio, image_urls et response_format ne sont pas pris en charge. Les champs non documentés sont ignorés et n’activent pas ces fonctions. Les importations multipart, Base64 et les URI data sont refusés.

Dimensions de sortie

La génération accepte 1K, 1.5K, 2K ou des dimensions exactes en pixels WIDTHxHEIGHT. Les dimensions exactes doivent totaliser 921 600–4 624 220 pixels et avoir un rapport d’image de 1:16 à 16:1. Par exemple, 2048x1152 est valide. Un rapport tel que 16:9 n’est pas une valeur de dimensions.

La décomposition en calques accepte auto, 1K, 1.5K ou 2K ; les dimensions exactes en pixels ne sont pas prises en charge dans ce mode. auto suit l’entrée et réserve le tarif de sortie supérieur. Le modèle ne propose pas de format prédéfini 3K ou 4K.

Images de référence et retouche

Fournissez des URL HTTP(S) publiques hébergées par vos soins, sans identifiants intégrés. Les formats pris en charge sont JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC et HEIF, jusqu’à 30 MB par image et 36 000 000 pixels au total. AVIF et JP2 ne sont pas pris en charge. L’URL doit servir directement une image sans connexion ni vérification du navigateur.

{
  "model": "seedream-5-5",
  "prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
  "image": "https://your-cdn.example/lighthouse.jpg",
  "size": "2K"
}

Pour plusieurs références, transmettez un tableau d’URL et expliquez le rôle de chaque image dans le prompt. Le résultat reste une seule image. Les URL de référence des exemples sont fictives : remplacez-les par vos propres fichiers accessibles.

Décomposition en calques et reconnaissance de texte

{
  "model": "seedream-5-5",
  "image": "https://your-cdn.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  }
}

Le plafond inclut l’image de base ; 4 signifie au plus quatre images renvoyées, et non quatre calques plus une base. Le modèle peut en renvoyer moins. Omettez prompt pour une séparation automatique, ou nommez les éléments à séparer. Un prompt peut supprimer le texte qu’il exclut.

Les calques sont des fichiers PNG transparents. Reconstruisez l’image par ordre croissant de z_index, avec la base à 0. Si un cadre englobant est fourni, redimensionnez le calque selon ce cadre avant de le placer : les dimensions en pixels du fichier du calque peuvent différer de ses dimensions de placement.

Le champ facultatif text_recognition contient le text complet et les lines. Chaque ligne peut inclure un bounding_box et des runs mis en forme. Le style d’un segment peut inclure similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow et translucent. Il s’agit d’estimations du modèle. Les lettrages artistiques ou manuscrits peuvent ne produire aucun résultat textuel ; traitez ce champ comme facultatif.

Réponse terminée

{
  "id": "task_example",
  "model": "seedream-5-5",
  "status": "completed",
  "created_at": 1794432000,
  "output": {
    "data": [
      {
        "url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
        "size": "1248x832",
        "output_format": "png"
      }
    ]
  }
}

Chaque image possède une url et une size. Les autres champs peuvent inclure output_format, background, z_index, name, description, bounding_box et text_recognition. bounding_box.absolute correspond à [left, top, right, bottom] en pixels de l’image de base. bounding_box.normalized utilise les mêmes coordonnées sur une échelle de 0–1 000. Ne présumez pas que les métadonnées facultatives existent sur chaque image.

Traitez les URL d’images comme des liens de téléchargement privés et enregistrez les fichiers nécessaires. Une URL contenant un jeton access peut être ouverte sans exposer la clé API de votre compte.

Tarifs

Image facturableUSD par image
Sortie jusqu’à 2,61 MP (1K / 1.5K)0,017 $US
Sortie au-delà de 2,61 MP (2K)0,02975 $US
Chaque image de référence, y compris la première0,0068 $US

Les tarifs s’actualisent automatiquement. Une clé API fonctionne avec tous les modèles et groupes.

Le seuil de pixels de sortie est de 2 610 000 pixels. Calculez la facture ainsi :

lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rate

Chaque référence est facturée, y compris la première et l’image source des calques. La génération et les calques utilisent les mêmes tarifs de sortie. L’envoi réserve une sortie, ou le plafond max_images des calques, plus les références. À la fin, le calcul utilise les dimensions réelles de chaque image renvoyée et libère la réservation inutilisée. La tâche acceptée conserve son instantané tarifaire même si les tarifs changent pendant son exécution. Les tâches échouées sont remboursées.

Erreurs et nouvelles tentatives

Les paramètres invalides sont refusés avant l’envoi. Un solde ou un quota de clé insuffisant empêche la génération. Les contrôles d’authentification et de propriété s’appliquent à l’envoi et à l’interrogation. Une tâche échouée renvoie status: "failed" avec un objet error.

Réessayez une lecture de statut échouée avec le même identifiant de tâche. Ne répétez pas automatiquement un POST de génération, même après un délai dépassé : il a peut-être déjà été accepté. Tant que le service en amont signale une progression normale, la tâche reste en attente. Une tâche sans statut normal en amont ni livraison réussie pendant trois heures continues échoue et est remboursée.

Consultez le tutoriel Seedream 5.5 pour une boucle applicative qui enregistre et reprend l’identifiant de tâche.

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.

API Claude

Utilisez Claude avec Anthropic Messages ou OpenAI Chat Completions : modèles, flux et tarifs actuels des tokens d’entrée, de sortie et du cache par groupe.

Sommaire

Authentification et points de terminaisonGénérer une imageParamètresDimensions de sortieImages de référence et retoucheDécomposition en calques et reconnaissance de texteRéponse terminéeTarifsErreurs et nouvelles tentatives