# API Seedream 5.5 (https://wanapi.app/fr/docs/seedream-5-5)





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](/fr/models/seedream-5-5#playground) · [JSON OpenAPI](/models/seedream-5-5/openapi.json) · [Tutoriel d’intégration](/fr/blog/seedream-5-5-api-guide)

## Authentification et points de terminaison [#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 &#x2A;*`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 [#générer-une-image]

```bash
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 :

```json
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}
```

```bash
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è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 [#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.

<span id="reference-images-and-editing" />

## Images de référence et retouche [#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.

```json
{
  "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 [#décomposition-en-calques-et-reconnaissance-de-texte]

```json
{
  "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 [#réponse-terminée]

```json
{
  "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 [#tarifs]

<Seedream55ModelPricing />

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

```text
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 [#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](/fr/blog/seedream-5-5-api-guide) pour une boucle applicative qui enregistre et reprend l’identifiant de tâche.
