Réponse rapide
- Appelez l'API asynchrone de tâches d'image avec model=doubao-seedream-5-5.
- size accepte les paliers 1K/1.5K/2K ou des pixels LxH explicites pour un total de 921 600 à 4 624 220 pixels.
- metadata.background=transparent renvoie un PNG RGBA. Pour les calques, max_images limite le total des sorties, base comprise : 2-100, 30 par défaut.
Paramètres clés
- model | string | requis | doubao-seedream-5-5 | - | Utilisez doubao-seedream-5-5 comme identifiant exact du modèle.
- prompt | string | facultatif | - | - | Obligatoire pour la génération et l'édition ; facultatif lorsque layer_decomposition=true.
- size | string | facultatif | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | En génération, la valeur par défaut du modèle s'applique et auto pour les calques. Les paliers ne fixent pas le ratio d'image ; les dimensions explicites doivent totaliser 921 600 à 4 624 220 pixels.
- image_urls | string[] | facultatif | - | 0-10 | Fournissez 1 à 10 images de référence JPEG, PNG ou WEBP via image_urls. Importez d'abord les fichiers locaux, puis utilisez les URLs renvoyées.
- n | integer | facultatif | 1 | 1 | Utilisez 1 ou omettez-le. La génération classique renvoie une image ; ce champ ne définit pas le nombre de calques.
- layer_decomposition | boolean | facultatif | false | - | Laissez désactivé pour la génération classique. Exige exactement une référence et aucun metadata.background. Renvoie une base et des calques PNG transparents ; layer_decomposition_options.max_images limite le total des sorties.
- layer_decomposition_options.max_images | integer | facultatif | 30 | 2-100 | Limite totale de sorties pour la décomposition en calques, base comprise. Ce n'est pas un nombre garanti ; le modèle décide du nombre de sorties nécessaires.
- layer_decomposition_options.text_recognition | boolean | facultatif | - | - | Contrôle la reconnaissance de texte pendant la décomposition en calques. Les résultats de la tâche n'incluent les métadonnées text_recognition que si le fournisseur les renvoie.
- metadata.output_format | string | facultatif | - | png | jpeg | Si omis, le format par défaut du fournisseur s'applique ; la transparence sélectionne png. Pour les calques, ne concerne que l'image de base ; les autres calques sont toujours en PNG.
- metadata.background | string | facultatif | - | auto | opaque | transparent | Uniquement pour la génération et l'édition. À omettre lorsque layer_decomposition=true, même avec opaque. transparent renvoie du PNG RGBA et n'accepte pas jpeg.
- metadata.watermark | boolean | facultatif | - | - | Définissez false pour désactiver le filigrane visible.
- metadata.response_format | string | facultatif | url | url | b64_json | Forme de livraison du résultat ; url est recommandé.
Erreurs courantes
- 400 invalid_input: déclencheur=Pixels de size hors plage, plus de 10 images de référence, ou layer_decomposition sans exactement une image d'entrée.; correctif=Vérifiez size, le nombre d'image_urls et les contraintes d'entrée de layer_decomposition dans la documentation.; nouvelle tentative=Ne réessayez qu'après avoir corrigé le payload.
- 429 rate_limit_exceeded: déclencheur=La fréquence des requêtes, la concurrence ou le quota atteignent la limite de taux.; correctif=Appliquez un backoff exponentiel, puis vérifiez le rythme des requêtes et l'utilisation du quota.; nouvelle tentative=Utilisez un backoff de 1s/2s/4s avec jitter.










