Fin dans—Modèles Wan jusqu’à 45 % moins chers que le prix officiel
LogoWan API
  • Modèles
  • Développeurs
  • Tarifs
  • Docs API
  • Guides
Tutoriel API Seedream 5.5 : générer, retoucher et séparer des images
12/11/2026

Tutoriel API Seedream 5.5 : générer, retoucher et séparer des images

Appelez Seedream 5.5 une fois, suivez la tâche, retouchez avec des références, créez PNG transparents et calques. Vérifiez dimensions et tarifs actuels.

Seedream 5.5 renvoie un identifiant de tâche avant de renvoyer une image. Envoyez la requête une seule fois, enregistrez cet identifiant et interrogez la tâche pour obtenir le résultat terminé. La génération produit une image ; la décomposition peut produire une image de base et des calques transparents. Les deux méthodes utilisent model: "seedream-5-5", mais leurs règles d’entrée diffèrent. 1

Ce tutoriel part d’un brief de théière en céramique pour générer une image puis effectuer une retouche ciblée, avant de montrer comment séparer une affiche existante en calques. L’espace d’essai Seedream 5.5 propose les mêmes réglages de requête. Vous pouvez y examiner le JSON avant de l’ajouter à une application.

Le contrat a été vérifié le 12 novembre 2026. Nos vérifications d’intégration ont rejoué 34 cas de requête et de réponse, dont des réglages de transparence incompatibles, des limites de calques et des sorties terminées sans dimensions exploitables. Ces vérifications valident le traitement des requêtes et les données de comptabilisation ; elles ne constituent pas un test comparatif de vitesse de génération ou de qualité d’image. Les images ci-dessous sont des exemples Seedream 5.5 existants du 10 novembre.

Commencez avec une clé et une petite requête

Créez une clé dans Clés API, conservez-la sur votre serveur et utilisez https://api.wanapi.app comme URL de base. Votre clé Wan API existante fonctionne avec tous les modèles et groupes disponibles. Vous n’avez pas à acheter ni sélectionner une clé distincte pour ce modèle d’image.

Enregistrez ceci dans generate.json :

{
  "model": "seedream-5-5",
  "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
  "size": "1K",
  "output_format": "png",
  "content_filter": true
}

Définissez WAN_API_KEY dans l’environnement de votre serveur, puis envoyez une seule fois :

curl --fail-with-body --retry 0 --max-time 90 \
  https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @generate.json \
  -o submitted.json

Une réponse réussie contient id, model et un statut de traitement. Conservez le fichier submitted.json entier. N’interprétez pas l’absence d’URL d’image comme un échec de génération : cette réponse confirme la prise en charge de la tâche. Si la connexion est interrompue avant la réception d’un identifiant, consultez les journaux de tâches avant de tenter un autre POST. Une réponse incertaine n’autorise pas à recréer la même tâche payante.

Nous avons explicitement choisi 1K pour cette première requête. Si vous omettez size, la génération utilise 2K par défaut. PNG est le format par défaut, le filigrane est désactivé et la modération du contenu est activée. Les utilisateurs de l’API publique peuvent modifier explicitement content_filter ; l’espace d’essai maintient la modération activée pour les comptes ordinaires. 1

Interrogez l’identifiant enregistré, même après actualisation

L’URL d’interrogation est GET /seedream55/v1/tasks/{id}. Une réponse terminée place les images dans output.data ; elle n’utilise pas la structure de réponse synchrone de l’API Images. Chaque entrée contient une URL et ses dimensions réelles en pixels.

Ce script Python lit la réponse enregistrée et interroge la tâche pendant dix minutes maximum. Il envoie uniquement des requêtes GET ; le relancer poursuit donc la tâche existante :

import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path

saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    request = urllib.request.Request(
        url,
        headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            task = json.load(response)
    except urllib.error.HTTPError as error:
        if error.code != 429 and error.code < 500:
            raise
        time.sleep(5)
        continue
    except (urllib.error.URLError, TimeoutError):
        time.sleep(5)
        continue

    if task["id"] != task_id:
        raise RuntimeError("Unexpected task identity")
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
    if task["status"] == "completed":
        Path("result.json").write_text(json.dumps(task, indent=2))
        for index, image in enumerate(task["output"]["data"], start=1):
            print(index, image["size"], image["url"])
        break
    time.sleep(5)
else:
    print("Still waiting. Keep submitted.json and resume this GET later.")

La limite de dix minutes appartient à cet exemple de client. Elle n’annule pas une tâche et ne prouve pas l’échec de la génération. Nous n’avons pas établi de plage de latence mesurée pour cette intégration : prévoyez donc un état d’attente plutôt que de promettre un nombre fixe de secondes. Enregistrez les fichiers téléchargés lorsqu’ils sont prêts ; ne considérez pas les URL de résultat comme un stockage permanent de ressources.

Théière renard en céramique sur une nappe en lin, générée avec Seedream 5.5

Cet exemple mesure 1 248 × 832 pixels. Le format prédéfini 1K est un niveau de résolution, sans garantie que les deux dimensions soient égales à 1 024. Lisez size dans le résultat lorsque votre mise en page ou votre calcul de coût nécessite les dimensions exactes.

Changez la scène en précisant ce qui doit rester

Pour une retouche, ajoutez image avec une URL HTTP(S) publique. Il peut s’agir d’une photo source que vous hébergez ou d’un fichier généré que vous avez téléchargé et hébergé vous-même. Les références ne peuvent pas être des fichiers importés, du Base64 ou des URI data. Elles doivent rester accessibles pendant le traitement de la requête. Les formats d’entrée et les limites de médias pris en charge figurent dans la référence API. 1

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/fox-teapot.png",
  "prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
  "size": "1K"
}

L’URL ci-dessus est fictive ; remplacez-la par votre image accessible. Envoyez-la comme une tâche de retouche distincte et intentionnelle, puis enregistrez sa réponse sous un nouveau nom de fichier. Le modèle ne se souvient pas de la tâche précédente : vous devez envoyer l’image à retoucher.

Pour plusieurs références, image accepte un tableau de dix URL maximum. Attribuez un rôle à chaque image dans le prompt, par exemple le produit de la première et le décor de la deuxième. Commencez par le plus petit ensemble utile. Si le résultat modifie un détail important, moins de références facilitent l’identification de l’instruction ou de la source à l’origine du changement.

La conservation est une instruction, pas un verrouillage des pixels. Après chaque retouche, comparez la silhouette du produit, les étiquettes et l’angle de caméra à l’original. Pour les affiches, citez le titre exact et vérifiez la ponctuation, les noms et les dates aux dimensions d’affichage prévues. Les petits caractères ou les lettrages stylisés peuvent encore nécessiter une correction manuelle ; ce guide ne promet aucun taux de précision mesuré pour quelque langue que ce soit.

Pour un détourage, ajoutez "background": "transparent" et conservez "output_format": "png". JPEG ne peut pas contenir ce canal alpha. La transparence est disponible pour la génération et la retouche ; le mode calques suit ses propres règles ci-dessous.

Séparez une affiche en calques réutilisables

La décomposition en calques prend exactement une image. Le prompt est facultatif : omettez-le pour laisser le modèle choisir les éléments, ou nommez les parties à séparer. Commencez avec un petit plafond de sortie lors de l’évaluation d’une création :

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

max_images compte aussi l’image de base. Quatre autorise donc la base et jusqu’à trois calques. Le plafond autorisé va de 2 à 100, avec 30 par défaut, et le modèle peut renvoyer moins d’images. N’envoyez pas background dans ce mode, même avec la valeur auto. Les calques séparés sont déjà des PNG transparents ; output_format contrôle l’image de base. 1

Affiche source Seedream 5.5, fond séparé, musicien et calques de texte transparents

Cet aperçu existant combine l’affiche source et les éléments transparents renvoyés. Il aide à comprendre la séparation, mais ne garantit pas que chaque affiche sera divisée en autant de calques ni que leurs contours seront nets.

Examinez les métadonnées facultatives associées à chaque résultat :

ChampUtilisation
z_indexPlacez les valeurs élevées au-dessus des valeurs basses.
bounding_box.absolutePlacez le calque à l’aide des coordonnées gauche, haut, droite et bas, en pixels de l’image de base.
bounding_box.normalizedLes coordonnées correspondantes sur une échelle de 0–1 000.
name, descriptionIdentifiez l’élément séparé par le modèle.
text_recognitionLisez le texte reconnu, les lignes et les informations de style disponibles.

Conservez le JSON complet du résultat, pas seulement ses URL. Un calque peut avoir des dimensions d’image différentes de celles de son placement sur le canevas de base. Utilisez le cadre englobant pour reconstruire la composition et vérifiez visuellement le résultat. Les suggestions de police sont des estimations ; les métadonnées OCR ne garantissent ni la police d’origine ni un fichier PSD prêt à l’emploi. Les lettrages artistiques, les éléments qui se chevauchent et le texte exclu par votre prompt peuvent produire des résultats incomplets.

Choisissez les dimensions avant de comparer les coûts

La génération prend en charge 1K, 1.5K et 2K, ainsi que des dimensions exactes WIDTHxHEIGHT totalisant 921 600–4 624 220 pixels, avec un rapport d’image de 1:16 à 16:1. Le mode calques accepte ces formats prédéfinis ou auto, mais pas les dimensions exactes. Ce contrat ne propose ni format prédéfini 3K ou 4K, ni traitement par lots n, ni seed, ni mode d’optimisation rapide du prompt. Ne reprenez pas les paramètres d’une autre version de Seedream sans les vérifier. 1

Les tarifs actuels ci-dessous proviennent de la même source que ceux de l’espace d’essai :

Les tarifs sont actuellement indisponibles. Actualisez cette page pour réessayer.

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

Soit L le tarif de sortie jusqu’à 2,61 millions de pixels, H le tarif au-delà de ce seuil et R le tarif d’une image de référence. Une génération 1K sans référence coûte L ; une retouche avec une référence coûte L + R. 1K et 1.5K utilisent tous deux le tarif de sortie inférieur. Chaque référence est facturée, y compris la première. 2

Une requête de calques 1K avec un plafond de quatre images est estimée à 4L + R. Si elle renvoie seulement la base et deux calques, chacun dans la tranche inférieure, le coût final est 3L + R. Pour des dimensions de sortie mixtes, comptez chaque image séparément : deux images de la tranche inférieure et une image plus grande coûtent 2L + H + R. La base est une image de sortie et ne doit pas être omise de ce décompte.

La réservation initiale couvre le plafond choisi. Les fonds inutilisés sont libérés après la comptabilisation des sorties réelles, et une tâche échouée est remboursée. Dans nos tests de comptabilisation, rejouer la même réponse terminée n’a pas modifié le solde une seconde fois. Nous avons aussi vérifié qu’une réponse terminée sans toutes les données d’utilisation des images requises restait non comptabilisée au lieu de traiter les quantités estimées comme des sorties observées.

Quand une requête ou un résultat nécessite votre attention

Une erreur de validation indique généralement une incompatibilité de mode : plusieurs références en mode calques, un JPEG transparent, des dimensions non prises en charge ou des options de calques sur une requête de génération. Corrigez la requête avant de créer une nouvelle tâche. Une erreur temporaire d’interrogation est différente : conservez l’identifiant existant et réessayez le GET. Ce sont des décisions distinctes ; les réunir dans un gestionnaire générique qui « réessaie tout » risque de dupliquer une génération payante.

Pour une retouche décevante, comparez un changement à la fois à la source. Une sortie plus grande ne prouve pas que le modèle a conservé une étiquette ou correctement rendu un titre. Pour les calques, examinez les contours et les métadonnées manquantes avant d’importer le résultat dans une création de production. La modération du contenu reste activée par défaut ; un rejet de contenu ne doit pas déclencher de nouvel envoi automatique avec la modération désactivée.

Seedream 5.5 convient aux méthodes nécessitant génération, retouches par références ou éléments graphiques séparables dans le cadre de ce contrat. Seedream 5.0 Pro est un modèle distinct, avec d’autres réglages par défaut et limites. Nous n’avons pas réalisé de comparaison contrôlée permettant d’affirmer que l’un est toujours meilleur. Ce guide ne revendique pas non plus la disponibilité d’un « 5.5 Pro » distinct ni une génération gratuite. Consultez la page du modèle pour l’espace d’essai et le prix actuels, ou utilisez le document OpenAPI pour intégrer la validation des requêtes à votre application.

Références

  1. Référence API Seedream 5.5 : champs de requête, valeurs par défaut, entrées URL, réponses asynchrones et métadonnées de calques. Contrat vérifié le 12 novembre 2026.
  1. Tarifs actuels Seedream 5.5 : tranches de pixels de sortie et tarifs des images de référence.
Tous les articles

Auteur

avatar for Wan API
Wan API

Catégories

  • Produit
Commencez avec une clé et une petite requêteInterrogez l’identifiant enregistré, même après actualisationChangez la scène en précisant ce qui doit resterSéparez une affiche en calques réutilisablesChoisissez les dimensions avant de comparer les coûtsQuand une requête ou un résultat nécessite votre attentionRéférences

Autres articles

Seedance 2.0 Fast ou Mini : lequel tester ?
Produit

Seedance 2.0 Fast ou Mini : lequel tester ?

Comparez Seedance 2.0 Fast et Mini : limites, coût des références vidéo et exemples. Testez un même brief pour évaluer qualité, délai et coût par plan accepté.

avatar for Wan API
Wan API
15/10/2026
Seedance 2.5 Flash : tarifs
Produit

Seedance 2.5 Flash : tarifs

Calculez le tarif d’un plan de cinq secondes avec Seedance 2.5 Flash. Comparez les tarifs en direct en 480p et 720p selon l’entrée et le montage.

avatar for Wan API
Wan API
18/11/2026
Seedance 2.5 ou Seedance 2.0 : lequel pour votre scène ?
Produit

Seedance 2.5 ou Seedance 2.0 : lequel pour votre scène ?

Comparez la durée, les limites de référence et les exemples Seedance 2.5 et 2.0. Préparez un test vidéo sans présumer d’un gagnant en qualité ou en vitesse.

avatar for Wan API
Wan API
14/10/2026

Actualités de Wan API

Nouveautés du service et des modèles

Inscrivez-vous pour recevoir les actualités des modèles, les nouveautés du service et les informations d’intégration API.

LogoWan API

Wan 3.0 et Wan 3.0 Prime. La génération vidéo pour votre prochain projet.Plateforme indépendante, sans affiliation avec Alibaba, Wan ou ByteDance ni approbation de leur part.

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
Modèles
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • Tarifs
Développeurs
  • Documentation
  • Guide Wan 3.0
  • FAQ
  • À propos de Wan API
  • Contacter Wan API
Informations légales
  • Confidentialité
  • Conditions
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. Tous droits réservés.