Skip to main content
POST
Utilisez la route OpenAI-compatible POST /v1/images/generations de CometAPI pour exécuter la génération d’images Seedream. Ce endpoint prend en charge les prompts texte-vers-image, les requêtes avec image de référence et la sortie d’images séquentielle bornée lorsque le modèle sélectionné prend en charge ces contrôles. Cette page couvre seedream-5-0-pro-260628 pour les requêtes Pro texte-vers-image et seedream-5-0-260128 pour les exemples Seedream 5.0 avec image de référence, génération séquentielle et traitement asynchrone. Pour la disponibilité sur votre compte, consultez la page Models ou interrogez /v1/models. Pour les détails des paramètres du fournisseur, consultez l’API de génération d’images de BytePlus ainsi que le tutoriel Seedream 4.0-5.0.

​
Choisir une forme de requête

  • Texte vers image : envoyez model, prompt, size et des contrôles de sortie optionnels tels que response_format, output_format et watermark.
  • Image vers image : ajoutez image sous forme de tableau d’URL HTTPS publiques ou de data URI. Utilisez un tableau même lorsque vous envoyez une seule image de référence.
  • Prompt séquentiel : définissez sequential_image_generation sur auto et utilisez sequential_image_generation_options.max_images comme limite supérieure. Le modèle peut renvoyer moins d’images que le maximum.
  • Tâche asynchrone : ajoutez async: true lorsque vous voulez que la requête de création renvoie data.task_id au lieu de garder la connexion HTTP ouverte.
Les images de référence plus les images générées doivent rester dans la limite du fournisseur. Maintenez les requêtes séquentielles bornées avec max_images.

​
Exécuter une tâche d’image asynchrone

Définissez async sur true pour les tâches d’image que votre client doit soumettre puis interroger. La requête de création renvoie data.task_id ; utilisez cette valeur avec Récupérer une tâche d’image Seedream jusqu’à ce que data.status soit success ou failure. Utilisez 2K dans les exemples asynchrones pour les requêtes Seedream 5.0. La prise en charge des tailles varie selon le model ID ; choisissez donc une taille prise en charge par le modèle avant de soumettre une tâche asynchrone.

​
Envoyer des images de référence

Utilisez data:image/png;base64,YOUR_BASE64_IMAGE pour des données d’image en ligne, ou utilisez une URL HTTPS publique que le fournisseur peut récupérer. Les exemples de la référence API montrent la structure JSON complète pour chaque type de requête.

​
Lire les URL de sortie

L’élément url renvoyé est un lien signé de stockage d’objets et peut contenir &, % et d’autres caractères spéciaux. Extrayez l’URL à partir du JSON analysé au lieu de copier une ligne partielle du terminal. Dans les exemples shell, jq -r '.data[]?.url' préserve l’URL signée complète.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

Parameters for Seedream image generation. Send JSON for text-to-image, image-to-image, and sequential prompt requests.

​
model
string
défaut:seedream-5-0-pro-260628
requis

Seedream model ID to use. Query /v1/models or open the Models page for available model IDs.

​
prompt
string
défaut:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.
requis

Text prompt describing the image or edit goal. Use a concrete visual request, such as a blue ceramic mug on a white table, soft studio lighting.

​
response_format
enum<string>
défaut:url

Response image format. Use url for a temporary signed image URL, or b64_json when you need base64 image data in the response.

Options disponibles:
url,
b64_json
​
size
string
défaut:2K

Output resolution. Use a model-supported tier such as 2K or a model-supported WIDTHxHEIGHT value such as 2048x2048. Not every model ID accepts every tier.

​
image
string[]

Optional reference images for image-to-image generation. Each item can be a public HTTPS URL or a data URI such as data:image/png;base64,YOUR_BASE64_IMAGE. Use an array even for one image. Reference images plus generated images must not exceed the provider limit.

​
watermark
boolean
défaut:false

When true, requests a visible AI-generated watermark on the output image. Set false when your workflow handles disclosure separately.

​
async
boolean
défaut:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll the Seedream image task endpoint GET /v1/images/generations/{task_id} for the final image data.

​
output_format
enum<string>
défaut:png

Output image file format. Use png when you need lossless output, or jpeg for smaller files.

Options disponibles:
png,
jpeg
​
guidance_scale
number

Optional prompt-adherence control for model versions that support it. Higher values can follow the prompt more closely but may reduce naturalness. Omit this field when you do not need model-specific tuning.

Plage requise: 1 <= x <= 10
​
seed
integer
défaut:-1

Optional random seed for reproducible attempts on model versions that support seeding. Use -1 or omit the field for a random seed.

Plage requise: -1 <= x <= 2147483647
​
sequential_image_generation
enum<string>
défaut:disabled

Controls sequential prompt handling. Use auto to let the model return a sequence when the prompt calls for one. Use disabled for ordinary single-image requests.

Options disponibles:
auto,
disabled
​
sequential_image_generation_options
object

Options for sequential prompt handling. This object is only used when sequential_image_generation is auto.

Réponse

200 - application/json

Image generation response. Synchronous requests return completed image data. Async requests return a task response with data.task_id.

​
created
integer
requis

Unix timestamp in seconds when the image response was created.

​
data
object[]
requis

Generated image results. The array can contain one or more images depending on the request and model response.

​
usage
object

Usage information for the request. Fields vary by model and route.