Seedream 5.5

Utilisez le modèle doubao-seedream-5-5-261028 avec POST https://apimaster.ai/v1/images/generations, un corps JSON et Authorization: Bearer YOUR_API_KEY. Créez votre clé APIMaster dans la console.

Prend en charge la génération texte-image, l'édition avec jusqu'à dix références, l'édition successive, la sortie RGBA transparente native, la décomposition en calques et l'OCR de texte enrichi. La génération normale renvoie une image. La décomposition renvoie une base et des calques séparés. Le streaming, la génération séquentielle d'images et la recherche web ne sont pas pris en charge. Utilisez le point de terminaison synchrone ; accordez au moins 300 secondes avant un délai d'expiration client et évitez toute resoumission aveugle.

Tarification de base officielle

Vérifié selon les tarifs Volcengine le 2026-11-13. Le taux de conversion configuré était de 7 CNY par USD.

Élément	CNY par image	Prix de base approximatif en USD
Chaque référence d'entrée, y compris la première	0.05	0.00714286
Sortie avec largeur × hauteur ≤ 2,610,000 pixels	0.13	0.01857143
Sortie au-dessus de 2,610,000 pixels	0.23	0.03285714

La génération et la décomposition utilisent les mêmes tarifs de sortie. Facturez chaque base/calque séparément en fonction de son data[].size réel ; le bord le plus long ne détermine pas le palier. 2048x1024 se trouve dans le palier inférieur. Deux entrées plus une sortie de palier supérieur coûtent 0.33 CNY avant les multiplicateurs de compte/canal. Contrairement à Seedream 5.0 Pro, la première référence n'est pas gratuite. Les frais réels du compte incluent les coefficients applicables de canal/groupe d'utilisateurs et l'arrondi entier des quotas. Consultez la fiche du modèle en direct et les journaux d'utilisation.

Génération texte-image

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Paramètres

Champ	Type / valeur par défaut	Règles
model	chaîne requise	doubao-seedream-5-5-261028.
prompt	chaîne	Requis pour la génération ; facultatif pour la décomposition. Décrivez le contenu, le style, le rapport d'aspect, le texte ou l'emplacement de l'édition. Les recommandations officielles de rédaction préconisent ≤300 caractères chinois ou ≤600 mots anglais ; il s'agit de recommandations plutôt que d'une limite d'octets.
image	chaîne ou chaîne[]	URL publique ou data:image/png;base64,.... Jusqu'à dix références de génération ; exactement une entrée pour la décomposition. Les chemins de fichiers locaux ne fonctionnent pas.
size	chaîne	La génération utilise par défaut 2K ; 1K, 1.5K, 2K ou WIDTHxHEIGHT exact. La décomposition utilise par défaut auto, accepte uniquement auto et ces trois paliers.
output_format	chaîne, png	png ou jpeg. Pour la décomposition, cela ne contrôle que la base ; les calques sont toujours en PNG.
background	chaîne, auto	auto, transparent ou opaque, pour la génération uniquement. La sortie transparente nécessite PNG ; omettez entièrement ce champ pour la décomposition.
response_format	chaîne, url	url ou b64_json. Lisez le champ correspondant dans chaque élément data[].
watermark	booléen, true	Définissez false pour omettre le filigrane visible de génération par IA.
optimize_prompt_options	objet	Seul {"mode":"standard"} est pris en charge par 5.5 ; fast n'est pas pris en charge.
layer_decomposition	booléen, false	Activez la décomposition d'une image PNG/JPEG.
layer_decomposition_options	objet	Options de décomposition ci-dessous.
layer_decomposition_options.max_images	entier, 30	2–100, base incluse. Un maximum, pas un nombre garanti.
layer_decomposition_options.text_recognition	booléen, false	Demandez l'OCR de texte enrichi pour les calques de texte normal.
safety_identifier	chaîne	Identifiant utilisateur stable en anglais, au maximum 64 caractères ; utilisez un hachage au lieu d'informations de contact personnelles.

N'utilisez pas les resolution, quality, n ou seed d'un autre modèle pour contrôler ce modèle. Ils ne sont pas répertoriés comme ses contrôles de génération correspondants dans l'API officielle. Définissez les limites de décomposition avec layer_decomposition_options.max_images.

Tailles et restrictions d'entrée

Pour la génération ordinaire, choisissez un palier (1K, 1.5K, 2K) et décrivez le rapport d'aspect dans le prompt, ou fournissez des dimensions exactes. La surface de sortie exacte doit être de 921,600–4,624,220 pixels, avec un rapport d'aspect 1:16–16:1, en satisfaisant les deux contraintes. 2880x1440 est valide ; 512x512 est trop petit. Il n'existe pas de palier 4K.

La décomposition n'accepte pas de dimensions exactes. Avec auto, les tailles de base/calque dans la plage prise en charge conservent leurs dimensions d'origine lorsque cela est possible ; les éléments plus petits/plus grands sont mis à l'échelle vers 1K/2K tout en préservant leur rapport d'aspect. Les calques renvoyés peuvent occuper différents paliers de facturation.

Contrainte d'entrée	Génération/édition	Décomposition
Nombre	Jusqu'à 10	Exactement 1
Formats	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Taille de fichier par image	≤30 MB	≤30 MB
Surface en pixels	196–36,000,000 ; les deux côtés >14 px	262,144–36,000,000
Rapport d'aspect	1:16–16:1	1:16–16:1

Utilisez des types MIME en minuscules dans les URL de données. Les URL d'entrée distantes doivent être accessibles au service.

Édition et images transparentes

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

Pour une entrée, image peut être une chaîne. Pour des éditions successives, transmettez explicitement la sortie précédente comme entrée suivante : il ne s'agit pas d'une conversation avec état, et chaque requête est facturée séparément. Décrivez les coordonnées/zones/flèches dans le prompt ou dessinez des marques sur la référence ; il n'existe pas de paramètre de positionnement mask documenté séparément pour cette interface.

Pour une génération transparente native, omettez image si inutile et définissez background: "transparent", output_format: "png", avec un prompt tel que « un papillon en verre bleu translucide, élément isolé, fond transparent ». L'édition peut utiliser jusqu'à dix références ; elles n'ont pas besoin d'avoir déjà des canaux alpha. transparent plus jpeg est invalide. Le background d'une réponse décrit la transparence réelle (transparent ou opaque).

Décomposition et OCR de texte enrichi

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Prend en charge une base plus jusqu'à 99 calques. max_images: 4 inclut la base. Omettez background ; chaque calque est un PNG transparent. L'échec d'un calque individuel fait échouer toute la requête plutôt que de renvoyer un succès partiel.

Lisez toutes les entrées data[] :

• url/b64_json, size et output_format identifient l'artefact et ses dimensions réelles ; background est disponible le cas échéant.
• z_index: 0 identifie la base ; les indices plus grands apparaissent au-dessus des plus petits.
• name et description décrivent le calque.
• bounding_box.absolute est [left,top,right,bottom] en pixels de base de sortie. Redimensionnez un calque à (right-left) × (bottom-top) et placez-le à (left,top) ; les dimensions du fichier de calque peuvent différer de son empreinte sur le canevas.
• bounding_box.normalized utilise des coordonnées 0–1000. Multipliez les coordonnées horizontales/verticales par la largeur/hauteur du canevas cible et divisez par 1000.
• text_recognition apparaît uniquement lorsqu'il est demandé et que le calque contient du texte normal reconnu. L'écriture manuscrite, le lettrage artistique et les calques non textuels peuvent l'omettre.

L'OCR contient text et lines[] ; chaque ligne possède son propre bounding_box et un runs[] stylisé. Chaque segment possède text et style, qui peuvent contenir similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow et translucent. Il s'agit d'interprétations visuelles approximatives, et non de propriétés de conception d'origine exactes ; la reconnaissance de police peut renvoyer unknown.

Réponse, stockage et échecs

La réponse contient created, model, data[], usage.input_images et usage.generated_images. Le nombre généré inclut la base et les calques. Conservez les métadonnées complètes de la réponse. Les URL de téléchargement d'origine du fournisseur expirent après 24 heures ; téléchargez/archivez rapidement vos ressources.

Corrigez les dimensions non valides, les nombres de références ou les options de transparence incompatibles avant de réessayer. Traitez séparément l'authentification, les autorisations, la modération, les limites de débit et les échecs en amont ; n'interprétez jamais une erreur comme une génération réussie. Les limites IPM comptent les images générées par compte/version de modèle ; la décomposition réserve max_images et renvoie la capacité inutilisée après achèvement, tandis que la facturation utilise les images réellement produites.

Sources officielles : Seedream 5.5, API de génération d'images, tarification. Paramètres vérifiés le 2026-11-13.