Comment utiliser l’API Seedream 5.5

Seedream 5.5 est disponible sur EmpirioLabs. C’est le tout nouveau modèle d’image Seedream de ByteDance, sorti le 9 novembre 2026 pour text-to-image génération, avec des modifications combinant jusqu’à 10 images de référence, des images avec réelle transparence réalisées à partir d’une invite ou de références, et la décomposition de calques, qui divise une image en une image de base plus jusqu’à 99 calques transparents et peut lire le texte qu’elles contenent. Cela fonctionne dans l’API et dans le Playground.

Regardez le film de lancement

Chaque film du film a été réalisé par Seedream 5.5 via l’API EmpirioLabs à 2K, incluant un apnéiste à côté d’une baleine à bosse, un danseur de flamenco en plein tour, un souffleur de verre au travail et une affiche jazz lettrée. La musique a été produite par ACE-Step sur EmpirioLabs. Regardez-le sur YouTube.

Comment cela se compare

Ce qu’il supporte

• Texte en image. Envoyez une invite sans image.
• Montage et fusion. Attachez une à dix images et décrivez le changement, ou comment les combiner.
• Modifications de marqueurs et de coordonnées. Marquez la zone à modifier sur l’image d’entrée avec un cercle, une flèche ou un croquis, ou indiquez sa position exacte sous forme de <bbox> Taguez dans la suggestion.
• Images transparentes. Jeu Contexte à transparent pour obtenir une PNG avec un canal alpha, uniquement à partir d’une invite ou d’images de référence.
• Décomposition des couches. Séparez une image en une image de base plus jusqu’à 99 calques PNG transparents, chacun affichant sa position dans l’image de base, un nom et une description.
• Reconnaissance de texte. Lors d’une décomposition, obtenez le texte de chaque couche de texte imprimé avec ses positions de lignes et son style.
• Texte dans l’image. Des panneaux, étiquettes, affiches et petits caractères sont rendus en chinois, anglais et dans 14 autres langues, dont le japonais, le coréen, l’arabe, l’espagnol et le français.

La sortie est PNG par défaut, ou JPEG, à la résolution 1K, 1,5K ou 2K, ou à une largeur et une hauteur personnalisées.

Générer une image

curl https://api.empiriolabs.ai/v1/images/generations \ -H « Autorisation: Porteur $EMPIRIOLABS_API_KEY » \ -H « Type-Contenu: application/json » \ -d '{ « modèle »: « seedream-5-5 », « prompt »: « Une tasse de café en céramique à côté d’un petit panneau tableau noir où l’on peut lire Oat Flat White 4.50, lumière de fenêtre du matin », « aspect_ratio »: « 4:3 », « qualité »: « 2K » }'

La requête attend l’image finale puis la renvoie Données. Ajouter « sync »: faux pour retrouver un emploi immédiatement, avec un aide-emploi pour voter à ALLEZ-/v1/jobs/<job_id> jusqu’à ce que sa Statut est achevé.

Le même appel du SDK Python d’OpenAI, pointé vers EmpirioLabs. Les contrôles que le SDK ne définit pas entrent extra_body:

from openai import client OpenAI = OpenAI(base_url="https://api.empiriolabs.ai/v1", api_key="YOUR_EMPIRIOLABS_API_KEY »,) result = client.images.generate(model="seedream-5-5 », prompt="Un terrarium en verre avec un minuscule paysage de mousse et une étiquette en laiton indiquant Fern Garden », extra_body={"aspect_ratio »: « 4:3 », « quality »: « 2K"},) print(result.data[0].url)

Créer une image transparente

Jeu Contexte à transparent. Il fonctionne uniquement à partir d’une invite, et sur des modifications allant jusqu’à 10 images de référence qui n’ont pas besoin d’un canal alpha propre. La sortie doit être PNG:

{ « mannequin »: « seedream-5-5 », « prompt »: « Lanterne en papier rouge brillant avec des pompons dorés, découpe isolée de produit », « fond »: « transparent », « qualité »: « 1K » }

Chaque image retournée rapporte ce qu’elle contient réellement comme Contexte: transparent ou opaque. Partez Contexte à Auto, le défaut, et le modèle décide à partir de l’invite et du format de sortie.

Édition avec images de référence

Passer jusqu’à 10 URL d’images, URI de données ou images téléchargées dans image, et les désigner dans la consigne par leur ordre:

{ « modèle »: « seedream-5-5 », « invite »: « Accrocher la lanterne en papier rouge de l’image 1 depuis la branche de l’image 2, en gardant tout le reste de l’image 2 inchangé », « image »: [ « https://example.com/lantern.png", « https://example.com/branch-poster.png" ] }

Modifier une zone marquée

Pour modifier une partie d’une image, marquez-la sur l’entrée avec un cercle, une flèche ou un croquis et décrivez le changement, ou indiquez la zone comme un <bbox> Tag. Une boîte, c’est gauche en haut droite en bas sur une grille de 0 à 1000 au-dessus de l’image, quelle que soit sa taille de pixel:

{ « modèle »: « seedream-5-5 », « invite »: « Ajoutez un petit vase en verre avec une seule tulipe blanche à <bbox>l’intérieur du 60 80 300 520</bbox>. Gardez tout le reste inchangé. », « image »: « https://example.com/kitchen.png" }

Diviser une image en calques

Jeu layer_decomposition à Vrai et joindre exactement une image. La demande est optionnelle: la laisser de côté pour laisser le modèle choisir les éléments, ou nommer les éléments ou régions à séparer. max_images fixe le plus grand nombre d’images à retourner, l’image de base incluse, de 2 à 100, et text_recognition Ajoute le texte de chaque couche de texte imprimé:

curl https://api.empiriolabs.ai/v1/images/generations \ -H « Autorisation: Porteur $EMPIRIOLABS_API_KEY » \ -H « Type-de-contenu: application/json » \ -d '{ « modèle »: « seedream-5-5 », « layer_decomposition »: true, « image »: « https://example.com/magazine-cover.png", « max_images »: 10, « text_recognition »: vrai }'

données[0] est l’image de base, avec un z_index de 0. Chaque entrée qui lui suit est une couche PNG transparente avec son ordre d’empilement, sa case dans l’image de base en pixels (bounding_box.absolu) et sur la grille de 0 à 1000 (bounding_box.normalisé), tous deux comme [gauche, haut, droite, bas], ainsi qu’un nom et une description. Un calque de texte imprimé contient également text_recognition:

{ « url »: « https://media.empiriolabs.ai/...", « z_index »: 1, « width »: 1723, « height »: 609, « bounding_box »: { « absolute »: [75, 0, 995, 325], « normalized »: [69, 0, 921, 301] }, « name »: « Top yellow big seriif title Seedream », « description »: « Large label jaune titulaire indiquant \"Seedream\ » positionné en haut de la composition. », « text_recognition »: { « texte »: « Seedream », « lines »: [ { « bounding_box »: { « absolu »: [196, 53, 874, 231], « normalisé »: [181, 49, 809, 214] }, « exécutions »: [ { « texte »: « Seedream », « style »: { « similar_font_family »: « HTF Didot », « foreground_color »: « #F5E25A », « gras »: faux, « italique »: faux, « sous-texte »: faux, « ombre »: faux, « ombre »: faux, « translucide »: faux } } ] } ] }, « fond »: « transparent » }

Empilez les calques sur l’image de base en ascendant z_index pour le reconstruire, ou déplacer, redimensionner, recolorer ou remplacer n’importe quel calque en premier. Avec le texte reconnu, un calque peut être retapé, traduit ou restylé et replacé dans la case de sa ligne.

Choses à savoir avant votre première demande

• Une image par demande. Une requête renvoie une image, et n au-dessus de 1 renvoie une erreur. Envoyez des requêtes séparées pour les variations. La décomposition des calques est l’exception: elle renvoie l’image de base et ses calques ensemble.
• Jeu max_images pour la décomposition dont vous avez besoin. Sans cela, une décomposition peut retourner jusqu’à 30 images, et chaque image retournée facture. Une valeur plus grande permet une division plus fine.
• Ajustez chaque couche à sa boîte. Un PNG de calque n’a pas toujours la taille de son empreinte dans l’image de base: dans l’exemple ci-dessus, un calque de 1723x609 remplit une case de 920x325. Ajustez chaque calque à la largeur et à la hauteur de sa bounding_box.absolu avant de la placer dans le coin supérieur gauche de la boîte.
• La reconnaissance de texte lit le texte imprimé. Le lettrage artistique et l’écriture manuscrite reviennent sous forme de couches sans text_recognition.
• La décomposition ne prend pas Contexte. Ses calques sont toujours PNG transparents, et le réglage Contexte à transparent ou opaque avec layer_decomposition renvoie une erreur.
• Un résultat transparent nécessite de la PNG. Contexte: « transparent » avec output_format: « jpeg » renvoie une erreur.

Prix

Par image. Seedream 5.5 est un paiement à l’usage et facturé par image retournée à sa taille: les images 1K et 1,5K partagent un tarif, et 2K les images facturent à un tarif plus élevé. Chaque image de référence ajoute un frais. Une décomposition de couches facture chaque image retournée, l’image de base et chaque couche, à sa propre taille. Vous pouvez payer au fur et à mesure, ou choisir un forfait avec des allocations hebdomadaires. Les tarifs actuels sont sur le page modèle et les page de prix.

Sécurité du contenu. Les images générées passent un contrôle automatisé de sécurité du contenu. Une image signalée comme explicite n’est pas retournée, et comme elle a été générée avant l’exécution de la vérification, elle est toujours facturée.

Commencez à construire

Essayez Seedream 5.5 dans le Playground, lisez la référence complète des paramètres dans le Docs API, ou le comparer avec les autres modèles d’image dans le Catalogue de modèles. Pour les modèles antérieurs de la famille, voir Comment utiliser l’API Seedream 5.0 Pro et Comment utiliser l’API Flash Seedream 5.0.