Passer au contenu principal
POST
/
v1
/
images
/
generations
curl -s https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "doubao-seedream-5-0-260128", "prompt": "a cat wearing a scarf sitting by the window watching rain, illustration style", "size": "2K", "response_format": "url", "watermark": false }' | jq -r '.data[].url' 
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Vue d’ensemble

Générez des images à l’aide des modèles Seedream de ByteDance via le point de terminaison standard compatible OpenAI /v1/images/generations. Prend en charge la génération text-to-image et image-to-image. Pour la liste complète des modèles, consultez la page Models. Pour une documentation détaillée des paramètres fournie par le fournisseur, consultez la documentation VolcEngine.
Lors de l’utilisation de la génération séquentielle (multi-image), définissez sequential_image_generation sur auto et configurez éventuellement sequential_image_generation_options.max_images pour limiter le nombre d’images de sortie. Le nombre total d’images de référence plus les images générées doit être ≤ 15.

​
Image-vers-image

Transmettez une ou plusieurs images de référence via le paramètre image (tableau d’URL ou de data URI base64) avec un prompt texte. Prend en charge jusqu’à 14 images de référence.

​
L’URL renvoyée affiche AccessDenied ?

L’url renvoyée est un lien signé de stockage d’objets qui contient & et d’autres caractères spéciaux.
Si vous copiez le JSON brut et le collez directement dans un navigateur ou un script, l’échappement du shell ou la troncature du terminal peut supprimer les paramètres de signature, ce qui entraîne :
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
Comment corriger :
  • curl : utilisez un pipe vers | jq -r '.data[].url' pour extraire l’URL proprement.
  • Python : utilisez result.data[0].url ou image["url"] — la chaîne est déjà complète ; transmettez-la directement à requests.get() ou webbrowser.open().
  • JavaScript : même principe — result.data[0].url.
  • Général : assurez-vous que les caractères & et % dans l’URL ne sont ni tronqués ni échappés deux fois.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

Parameters for Seedream image generation (text-to-image and image-to-image).

​
model
string
défaut:doubao-seedream-5-0-260128
requis

Model to use. See the Models page for current Seedream model IDs.

​
prompt
string
défaut:a cat wearing a scarf sitting by the window
requis

Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.

​
response_format
enum<string>
défaut:url

Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.

Options disponibles:
url,
b64_json
​
size
string
défaut:2048x2048

Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.

​
image
string[]

Reference image(s) for image-to-image generation. Each item is a public URL or base64 data URI (data:image/png;base64,...). Supports up to 14 reference images. Supported formats: jpeg, png, webp, bmp, tiff, gif.

​
watermark
boolean
défaut:true

When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.

​
guidance_scale
number
défaut:2.5

Controls how closely the output follows the prompt. Higher values increase adherence but may reduce naturalness. Range: 1.0–10.0. Not supported by Seedream 5.0 (ignored).

​
seed
integer
défaut:-1

Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.

​
sequential_image_generation
enum<string>
défaut:disabled

Controls sequential (multi-image) generation mode.

  • auto: model decides whether to generate a sequence based on the prompt
  • disabled: always generate a single image
Options disponibles:
auto,
disabled
​
sequential_image_generation_options
object

Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.

​
output_format
enum<string>
défaut:jpeg

Output image file format. Options: png, jpeg.

Options disponibles:
png,
jpeg

Réponse

200 - application/json

Successful Response

​
created
integer
requis

Unix timestamp (seconds) when the image was generated.

​
data
object[]
requis

Array of generated image objects.

​
usage
object
requis

Resource usage information for this request.

​
model
string

The model used for generation.