Seedream

​

1. Vue d’ensemble

​

Modèles pris en charge

​

2. Interface et authentification

POST https://{api_domain}/v3/bytedance/api/v3/images/generations

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

​

3. Paramètres de requête

​

3.1 Paramètres communs

​

3.2 Paramètres spécifiques aux modèles

​

3.3 Exemple de génération texte-vers-image

curl -sS -X POST "https://{api_domain}/v3/bytedance/api/v3/images/generations" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dola-seedream-5-0-pro-260628",
    "prompt": "一只戴着红色围巾的金毛犬，在雪山湖边的自然光下，电影感摄影",
    "size": "2K",
    "response_format": "url",
    "output_format": "jpeg",
    "watermark": true
  }'

​

3.4 Exemple de génération image-vers-image

{
  "model": "seedream-4-5-251128",
  "prompt": "将参考图中的人物和服装放在统一的城市夜景中，保持人物特征一致",
  "image": [
    "https://example.com/person.png",
    "https://example.com/outfit.png"
  ],
  "size": "2560x1440",
  "response_format": "url"
}

​

3.5 Exemple de série d’images (4.0, 4.5 et 5.0 Lite uniquement)

{
  "model": "seedream-5-0-260128",
  "prompt": "生成三张风格统一的四季海报",
  "sequential_image_generation": "auto",
  "sequential_image_generation_options": {
    "max_images": 3
  },
  "response_format": "url"
}

​

4. Réponse

{
  "created": 1786000000,
  "model": "seedream-4-5-251128",
  "data": [
    {
      "url": "https://example.com/generated-image.jpeg",
      "size": "2560x1440",
      "output_format": "jpeg"
    }
  ],
  "usage": {
    "generated_images": 1,
    "input_images": 0
  }
}

• Lorsque response_format=url, data[].url est renvoyé ; lorsque response_format=b64_json, data[].b64_json est renvoyé.
• Seedream 4.0, 4.5 et 5.0 Lite peuvent renvoyer plusieurs éléments data en mode série d’images.
• Seedream 5.0 Pro renvoie un élément data dans le scénario de génération d’images ; lorsque la décomposition en calques est activée, il renvoie plusieurs éléments data (une image de base + plusieurs calques), chacun incluant en plus l’ordre d’empilement du calque z_index (0 pour l’image de base), le nom name, la description description et la boîte englobante bounding_box (coordonnées absolute / normalized ; ce champ n’est pas renvoyé pour l’image de base).
• model renvoie l’ID de modèle côté client utilisé pour cette requête.
• La durée de validité des URL d’images est déterminée par la plateforme et le service en amont ; téléchargez et enregistrez les images rapidement après leur retour.

​

5. Limites des modèles

​

Seedream 4.0 / 4.5 / 5.0 Lite

• Prend en charge la génération texte-vers-image, image-vers-image et les séries d’images.
• Les séries d’images utilisent sequential_image_generation et son champ options.
• Le nombre d’images en entrée, la taille des images, la résolution et le rapport hauteur/largeur dépendent de la documentation en amont du modèle correspondant. Seedream 4.0 et 4.5 produisent toujours du JPEG et ne prennent pas en charge le paramètre de requête output_format ; Seedream 5.0 Lite prend en charge jpeg et png.

​

Seedream 5.0 Pro

• Prend en charge la génération texte-vers-image, image-vers-image à partir d’une seule image et la fusion de plusieurs images.
• Dans le scénario de génération d’images, une seule image réussie est renvoyée. Lorsque la décomposition en calques (layer_decomposition: true) est activée, une image de base et plusieurs calques (jusqu’à 16 calques) sont renvoyés, auquel cas data contient plusieurs éléments. La génération de séries d’images (sequential_image_generation) n’est pas prise en charge.
• sequential_image_generation et sequential_image_generation_options ne sont pas pris en charge.
• size peut être 1K, 1.5K, 2K ou une valeur explicite largeurxhauteur.
• Lorsque la largeur et la hauteur sont explicites, le rapport hauteur/largeur et le nombre total de pixels doivent respecter les limites du modèle ; les dimensions réelles de l’image de sortie sont celles indiquées dans data[].size de la réponse.
• Prend en charge la décomposition en calques : lorsque layer_decomposition: true est défini, une image d’entrée unique est décomposée en une image de base et jusqu’à 16 calques modifiables indépendamment (chaque calque étant un PNG avec canal alpha). Dans ce scénario, image est obligatoire et une seule image peut être transmise ; l’envoi de plusieurs images génère une erreur. La décomposition en calques est tout ou rien : si un calque échoue, toute la requête échoue ; la réussite partielle n’est pas prise en charge.
• Règles de size pour la décomposition en calques : la résolution de l’image de base est égale à size ; la résolution de chaque calque est proche de size, mais chaque calque conserve le rapport hauteur/largeur de sa zone correspondante dans l’image d’origine, de sorte que le nombre réel de pixels diffère d’un calque à l’autre. Cela signifie que les images de sortie d’une même requête peuvent relever de paliers de prix différents selon le nombre de pixels. size accepte 1K, 1.5K, 2K, auto ; auto par défaut.

​

6. Facturation et utilisation

• 4.0, 4.5 et 5.0 Lite sont facturés selon le nombre d’images générées avec succès ; pour les séries d’images, la facturation est calculée selon le nombre réel de sorties réussies.
• 5.0 Pro est facturé selon les images de sortie réussies ; en cas d’entrée de plusieurs images, la première image de référence est gratuite et les images de référence supplémentaires sont comptées séparément ; des dimensions de sortie différentes correspondent à des paliers de prix différents. Lorsque la décomposition en calques est activée, l’image de base et chaque calque comptent chacun comme une image de sortie réussie, chacun étant facturé séparément dans le palier de prix correspondant au nombre de pixels de son data[].size (par exemple, l’image de base dans un palier à pixels élevés et certains calques dans un palier à pixels faibles) ; la facture finale correspond à la somme des quantités de chaque palier.
• L’unité d’utilisation est « image » ou item.
• Pour les prix exacts, reportez-vous à la page des tarifs produits de votre plateforme.

​

7. Dépannage des erreurs