Generazione di immagini Seedream

Usa CometAPI POST /v1/images/generations per la generazione text-to-image e image-to-image di Seedream — supporta output multi-immagine sequenziali e immagini di riferimento.

POST /v1/images/generations

cURL

Text to Image (5.0)

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'

200

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "size": "<string>"
    }
  ],
  "usage": {
    "generated_images": 123,
    "output_tokens": 123,
    "total_tokens": 123
  },
  "model": "<string>"
}

​

Panoramica

Genera immagini usando i modelli Seedream di ByteDance tramite l’endpoint standard compatibile con OpenAI /v1/images/generations. Supporta sia la generazione text-to-image sia image-to-image.

Per l’elenco completo dei modelli, consulta la pagina Models. Per la documentazione dettagliata dei parametri del provider, consulta la documentazione VolcEngine.

Quando usi la generazione sequenziale (multi-immagine), imposta sequential_image_generation su auto e configura facoltativamente sequential_image_generation_options.max_images per limitare il numero di immagini in output. Il numero totale di immagini di riferimento più immagini generate deve essere ≤ 15.

​

Image-to-Image

Passa una o più immagini di riferimento tramite il parametro image (array di URL o data URI base64) insieme a un prompt testuale. Supporta fino a 14 immagini di riferimento.

​

L’URL restituito mostra AccessDenied?

L’url restituito è un link firmato di object storage che contiene & e altri caratteri speciali.
Se copi il JSON grezzo e lo incolli direttamente in un browser o in uno script, l’escaping della shell o il troncamento del terminale potrebbero rimuovere i parametri della firma, causando:

\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}

Come risolvere:

• curl: usa una pipe con | jq -r '.data[].url' per estrarre correttamente l’URL.
• Python: usa result.data[0].url o image["url"] — la stringa è già completa; passala direttamente a requests.get() o webbrowser.open().
• JavaScript: stessa idea — result.data[0].url.
• Generale: assicurati che & e % nell’URL non vengano troncati o sottoposti a escaping due volte.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

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

model · string · predefinito: doubao-seedream-5-0-260128 · obbligatorio

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

prompt · string · predefinito: a cat wearing a scarf sitting by the window · obbligatorio

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> · predefinito: url

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

Opzioni disponibili: url, b64_json

size · string · predefinito: 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 · predefinito: true

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

guidance_scale · number · predefinito: 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 · predefinito: -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> · predefinito: 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

Opzioni disponibili: auto, disabled

sequential_image_generation_options · object

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

Show child attributes

output_format · enum<string> · predefinito: jpeg

Output image file format. Options: png, jpeg.

Opzioni disponibili: png, jpeg

Risposta

200 - application/json

Successful Response

created · integer · obbligatorio

Unix timestamp (seconds) when the image was generated.

data · object[] · obbligatorio

Array of generated image objects.

Show child attributes

usage · object · obbligatorio

Resource usage information for this request.

Show child attributes

model · string

The model used for generation.