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éthode | URL | Objectif |
|---|---|---|
| POST | https://api.wanapi.app/seedream55/v1/images/generations | Envoyer une tâche d’image |
| GET | https://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ètre | Type | Valeur par défaut | Règles |
|---|---|---|---|
model | chaîne | obligatoire | seedream-5-5 |
prompt | chaîne | obligatoire pour la génération | Facultatif pour la décomposition en calques. |
image | URL ou tableau d’URL | aucune | Jusqu’à 10 références ; exactement une pour les calques. Chaque référence est facturée. |
size | chaîne | 2K, ou auto pour les calques | Voir les règles de dimensions ci-dessous. |
output_format | chaîne | png | png ou jpeg. Pour les calques, contrôle uniquement l’image de base. |
background | chaîne | auto | auto, opaque, transparent. La transparence nécessite PNG. Omettez entièrement ce champ en mode calques. |
layer_decomposition | booléen | false | Séparer une référence en une image de base et des calques PNG transparents. |
layer_decomposition_options.max_images | entier | 30 | Plafond total de 2–100 images, base comprise. Uniquement en mode calques. |
layer_decomposition_options.text_recognition | booléen | false | Demander les métadonnées de texte imprimé dans les calques. Uniquement en mode calques. |
optimize_prompt_options.mode | chaîne | standard | Le seul mode pris en charge est standard. |
watermark | booléen | false | Demander un filigrane indiquant un contenu généré par IA. |
content_filter | booléen | true | L’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 facturable | USD 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ère | 0,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 rateChaque 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.