# Seedream 5.0 Pro (https://wanapi.app/fr/docs/seedream-5-0-pro)
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](/fr/models/seedream-5-0-pro).
## Connexion à Wan API [#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](/fr/settings/apikeys) 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ètre | Seedream 5.0 Pro |
| --------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Identifiant du modèle | `bytedance/seedream-5.0-pro` |
| `size` | `1K`, `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. |
| `image` | Jusqu’à 10 images de référence. |
| Sortie | Une image par requête, ou une image de base et jusqu’à 16 calques avec `layer_decomposition`. |
## Générer une image [#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.
```bash
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 :
```json
{
"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 [#tarifs-seedream-50-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.
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 [#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.
| Champ | Type | Contrat |
| ------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `model` | chaîne | Obligatoire : `bytedance/seedream-5.0-pro`. |
| `prompt` | chaîne | Ce 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. |
| `image` | chaîne ou tableau de chaînes | Jusqu’à 10 images de référence sous forme d’URL HTTP(S) ou de `data:image/;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. |
| `size` | chaîne | Gé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_decomposition` | booléen | `false` par défaut. `true` sépare exactement une image PNG ou JPEG en une image de base et jusqu’à 16 calques. |
| `optimize_prompt_options` | objet | `{"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_format` | chaîne | `jpeg` (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. |
| `background` | chaîne | `opaque` (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. |
| `watermark` | booléen | `true` par défaut : ajoute une petite mention de génération par IA. Envoyez `false` pour la supprimer. |
| `nsfw_checker` | booléen | `true` 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_format` | chaîne | `url` (par défaut) ou `b64_json`. |
| `n` | entier | Facultatif ; 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 [#retoucher-et-combiner-des-images-de-référence]
Transmettez une image avec une instruction de retouche, ou plusieurs images à combiner :
```json
{
"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 [#décomposition-en-calques]
```json
{
"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 :
```json
{
"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 [#erreurs]
Les erreurs utilisent l’enveloppe d’erreur OpenAI `{"error": {"message", "type", "code"}}`.
| HTTP | `code` | Signification |
| ---- | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| 400 | `invalid_request` ou un message de validation | Un champ ou une combinaison n’est pas pris en charge. Corrigez la requête ; rien n’a été facturé. |
| 400 | `content_policy_violation` | Le prompt, une image d’entrée ou la sortie a été rejeté par la politique de contenu. Rien n’a été facturé. |
| 402 | quota insuffisant | Ajoutez des fonds avant un nouvel envoi. |
| 429 | `rate_limited` | Trop de requêtes. Réessayez plus tard. |
| 502 | `submission_unknown` | Le 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. |
| 503 | `upstream_unavailable` | La 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.