Seedream 5.0 Pro API

Seedream 5.0 Pro Layer Decomposition sépare une image terminée en une image de fond et jusqu’à seize calques PNG transparents. Chaque calque vient avec un cadre de position et un nom : vous pouvez ainsi reconstituer la composition d’origine ou la réorganiser sur un canevas.

Développé par ByteDance (ID de modèle dola-seedream-5-0-pro-260628). Utilisez-le quand les calques doivent revenir exactement là où ils étaient.

Choisir un mode selon le matériau de départ

Pro ou Flash pour les calques

Les deux paliers renvoient boundingBox et name pour chaque calque. Sur la même affiche de film, sans prompt, Pro a renvoyé neuf images et Flash huit. Les différences sont le prix et une limite de contenu. Pro coûte $0.042 par image produite en 1K et 1.5K et $0.084 en 2K ; Flash coûte $0.026 à tous les paliers. Pro refuse les images sources de niveau Très fort, tandis que Flash a décomposé le même type d'image en ses figures. Aucun des deux n’a été systématiquement plus rapide dans nos essais.

Cadres de position et noms

Chaque calque renvoie boundingBox sous la forme [x1, y1, x2, y2] en pixels de l’image de fond et un name comme « Woman in red trench coat ». Dans notre essai sur l’affiche, en superposant les calques à leurs cadres, on retrouvait l’affiche d’origine. Le PNG d’un calque est souvent plus grand que le cadre qu’il occupe (un cadre de 671 par 139 est venu avec un PNG de 1233 par 256) : redimensionnez-le dans le cadre au moment de le replacer.

Une image de fond propre

Les éléments séparés sont retirés et l’arrière-plan est complété. En séparant la publicité de parfum, il est resté une surface de marbre noir vide là où se trouvaient le flacon, le ruban et le lettrage.

Pilotez avec des mots ou des coordonnées

Nommez les éléments, ou précisez-les avec des coordonnées <bbox>. Sans prompt, le modèle choisit lui-même les éléments principaux.

Calques PNG transparents

Les calques sont toujours des PNG transparents, quel que soit le output_format choisi. Ce réglage ne change que l’image de fond.

Changer le texte d’une affiche

Sortez le calque du titre, remplacez-le ou restylez-le, puis remettez tout en pile aux cadres renvoyés.

Changer le fond d’un produit

Détachez le produit et son lettrage d’une publicité, gardez l’image de fond ou remplacez-la, et recomposez pour une nouvelle campagne.

Préparer des éléments de parallaxe ou d’animation

Transformez une illustration en calques ordonnés aux positions connues, prêts pour un mouvement de profondeur ou un rig.

Isoler une personne d’une scène

Demandez la personne seule et obtenez un calque transparent plus la scène sans elle.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedream-5.0-pro/layer-decomposition",
  "input": {
    "image_url": "https://example.com/reference.png",
    "output_format": "jpeg",
    "resolution": "1.5k"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.