Seedream 5.0 Pro

Seedream 5.0 Pro est le modèle d’images de ByteDance. Une requête crée une image à partir d’un prompt, ou d’un prompt et de jusqu’à 10 images de référence, ou décompose une image en une image de fond et jusqu’à 16 calques transparents. Envoyez la requête, conservez l’identifiant de tâche renvoyé et récupérez les images terminées dans la tâche. Les images de référence sont transmises sous forme d’URL.

ID de modèle

Consultez la page du modèle pour les prix actuels.

Exemple rapide

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5-0-pro",
    "prompt": "A red ceramic mug on a white table, soft studio light, product photography. No text, no logos.",
    "size": "1K",
    "watermark": false
  }'

Point de terminaison

POST https://api.seedrouter.ai/v1/images/generations

La réponse est une tâche ({"id": "task_...", "status": "processing"}), pas l’image terminée. Interrogez GET /v1/tasks/{task_id} pour obtenir le résultat. Gardez les clés API dans le code côté serveur. Les références et la décomposition en calques sont transmises dans la même requête via image ; /v1/images/edits n’est pas utilisé pour ce modèle et renvoie 400.

Paramètres

Les champs ne figurant pas dans cette liste sont supprimés avant la transmission de la requête ; ils ne provoquent jamais d’erreur et ne modifient jamais la sortie. n, stream, seed, response_format et la génération séquentielle ne sont pas disponibles. callback_url n’est pas disponible ; interrogez plutôt la tâche.

Taille de sortie

Le palier fixe l’échelle et le prompt fixe le format. Nommez le format d’image dans prompt (par exemple « un paysage en 16:9 ») pour que le modèle choisisse le cadre :

Pour un cadre fixe, envoyez des dimensions précises en pixels plutôt qu’un palier. 1K et 1.5K coûtent le même prix ; 2K et toute taille dépassant 2,61 millions de pixels coûtent plus cher (voir les facteurs de coût).

Images de référence

Passez une image pour la retoucher, ou 2–10 pour les combiner, et indiquez dans prompt ce qu’il faut conserver et modifier. Désignez-les par leur ordre (« la veste de l’image 1 »).

{
  "model": "seedream-5-0-pro",
  "prompt": "Put the jacket from image 1 on the model from image 2, standing on a rainy street at night.",
  "image": ["https://example.com/jacket.png", "https://example.com/model.jpg"],
  "size": "1.5K"
}

Décomposition en calques

Envoyez exactement une image avec layer_decomposition: true. La tâche renvoie d’abord l’image de fond, puis chaque calque en PNG transparent.

{
  "model": "seedream-5-0-pro",
  "image": "https://example.com/poster.png",
  "layer_decomposition": true,
  "prompt": "Separate the headline, the product and the background."
}

Chaque calque contient z_index (l’image de fond vaut 0 ; les nombres supérieurs se placent au-dessus), name, description et bounding_box. bounding_box.absolute correspond à [left, top, right, bottom] en pixels de l’image de fond ; bounding_box.normalized représente la même boîte en millièmes de la largeur et de la hauteur de l’image de fond. Pour reconstruire l’image, redimensionnez chaque calque à sa boîte et placez-le sur l’image de fond par ordre croissant de z_index.

Avec size: "auto", l’image de fond et chaque calque conservent leur taille dans l’image d’entrée. L’entrée doit être un PNG ou JPEG dont le nombre total de pixels (largeur × hauteur) est compris entre 262 144 (512 × 512) et 36 000 000 (6000 × 6000).

Fond transparent

Envoyez un PNG avec un canal alpha et background: "transparent" pour obtenir un PNG au fond transparent :

{
  "model": "seedream-5-0-pro",
  "prompt": "Turn this sticker into a glossy enamel pin, keep the outline.",
  "image": "https://example.com/sticker.png",
  "background": "transparent",
  "output_format": "png"
}

Entrées média

Chaque référence est une URL HTTP(S) publique. Les data URI en base64 ne sont pas acceptées : téléversez le fichier sur votre propre stockage et transmettez son URL. Les formats acceptés sont JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC et HEIF, jusqu’à 30 Mo chacun, entre 1:16 et 16:1, avec une largeur et une hauteur supérieures à 14 pixels et au plus 36 000 000 pixels au total. La décomposition en calques accepte uniquement PNG ou JPEG.

Facteurs de coût

Consultez la section tarifs du modèle pour les tarifs actuels. Seedream 5.0 Pro est facturé par image de sortie selon le scénario et le palier de pixels, avec un supplément pour chaque image de référence après la première :

generation:          cost = image price for its tier + extra references × reference price
layer decomposition: cost = images returned × per-image price for the request's tier

• Le palier inférieur couvre les images jusqu’à 2,61 millions de pixels (1.5K et moins) ; toute image plus grande relève du palier supérieur.
• La décomposition en calques facture l’image de fond et chaque calque. Toute la requête utilise un seul palier : le tarif inférieur s’applique uniquement si chaque image renvoyée reste dans la limite de 2,61 millions de pixels.
• Le montant réservé à l’acceptation d’une tâche couvre le résultat maximal : une image au palier demandé, ou 17 images pour la décomposition en calques (auto compte comme le palier supérieur). La tâche est ensuite facturée pour les images réellement renvoyées et la différence est libérée.

Consultez les frais définitifs dans l’historique d’utilisation de votre compte. Les tâches échouées ne sont pas facturées.

Schéma de sortie

L’envoi renvoie la tâche :

{"id": "task_...", "model": "seedream-5-0-pro", "status": "processing", "created_at": 1789689600}

Récupérer la tâche

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Interrogez toutes les 10 à 20 secondes jusqu’à ce que status vaille completed ou failed. Un dépassement de délai réseau pendant l’interrogation ne signifie pas que la génération a échoué : conservez l’identifiant de tâche et reprenez la vérification. Ne créez pas une autre tâche pour vérifier l’avancement.

Tâche terminée

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689653,
  "output": {
    "created": 1789689650,
    "data": [
      {
        "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg",
        "size": "1024x1024",
        "output_format": "jpeg"
      }
    ],
    "usage": { "output_tokens": 4096, "total_tokens": 4096 }
  }
}

Une tâche de décomposition en calques liste d’abord l’image de fond, puis chaque calque :

{
  "data": [
    { "url": "https://static.seedrouter.ai/media/tasks/task_example/0.jpg", "size": "832x1248", "output_format": "jpeg", "z_index": 0 },
    {
      "url": "https://static.seedrouter.ai/media/tasks/task_example/1.png",
      "size": "527x1044",
      "output_format": "png",
      "z_index": 1,
      "name": "Ceramic coffee cup",
      "description": "White ceramic cup with a matte glaze, extracted without the table.",
      "bounding_box": { "absolute": [212, 418, 610, 1206], "normalized": [255, 335, 733, 966] }
    }
  ]
}

Lors de nos tests, une image 1K a pris environ 35–55 secondes et une décomposition en calques en 1K renvoyant une image de fond et 13 calques a pris environ 140 secondes.

Erreurs

Les requêtes rejetées avant la création d’une tâche renvoient une erreur HTTP avec un objet error et ne sont pas facturées. Une tâche qui échoue après acceptation renvoie HTTP 200 lorsqu’on l’interroge, avec status: "failed" et un objet error.

Voir le catalogue d’erreurs commun pour les codes, les statuts HTTP et les conseils de reprise.

{
  "id": "task_...",
  "model": "seedream-5-0-pro",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Si l’envoi lui-même dépasse le délai, vérifiez vos tâches avant de renvoyer : la première requête a peut-être été acceptée.

Conseils

• Commencez en 1K ou 1.5K pour vos essais ; 1.5K coûte autant que 1K.
• Nommez le format dans le prompt lorsque vous utilisez un palier, ou envoyez des dimensions précises en pixels pour une mise en page fixe.
• Avec plusieurs références, indiquez ce que chacune apporte et désignez-les par leur ordre.
• Définissez watermark: false pour une image sans filigrane ; le réglage par défaut ajoute une mention.
• Pour la décomposition en calques, listez les éléments à séparer pour limiter le nombre de calques.

Ressources liées

• Playground et tarifs de Seedream 5.0 Pro
• Télécharger l’OpenAPI
• Markdown copiable