Saltar al contenido 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.

​
Resumen

Genera imágenes usando los modelos Seedream de ByteDance a través del endpoint estándar compatible con OpenAI /v1/images/generations. Admite tanto la generación de text-to-image como de image-to-image. Para consultar la lista completa de modelos, consulta la página de modelos. Para ver la documentación detallada de parámetros del proveedor, consulta la documentación de VolcEngine.
Al usar generación secuencial (múltiples imágenes), establece sequential_image_generation en auto y, de forma opcional, configura sequential_image_generation_options.max_images para limitar la cantidad de imágenes de salida. El total de imágenes de referencia más las imágenes generadas debe ser ≤ 15.

​
Imagen a imagen

Pasa una o más imágenes de referencia mediante el parámetro image (matriz de URL o URI de datos base64) junto con un prompt de texto. Admite hasta 14 imágenes de referencia.

​
¿La URL devuelta muestra AccessDenied?

La url devuelta es un enlace firmado de almacenamiento de objetos que contiene & y otros caracteres especiales.
Si copias el JSON sin procesar y lo pegas directamente en un navegador o script, el escape del shell o el truncamiento del terminal pueden eliminar los parámetros de firma, lo que produce:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
Cómo solucionarlo:
  • curl: canaliza mediante | jq -r '.data[].url' para extraer la URL correctamente.
  • Python: usa result.data[0].url o image["url"] — la cadena ya está completa; pásala directamente a requests.get() o webbrowser.open().
  • JavaScript: misma idea — result.data[0].url.
  • General: asegúrate de que & y % en la URL no se trunquen ni se escapen dos veces.

Autorizaciones

​
Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

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

​
model
string
predeterminado:doubao-seedream-5-0-260128
requerido

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

​
prompt
string
predeterminado:a cat wearing a scarf sitting by the window
requerido

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>
predeterminado:url

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

Opciones disponibles:
url,
b64_json
​
size
string
predeterminado: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
predeterminado:true

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

​
guidance_scale
number
predeterminado: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
predeterminado:-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>
predeterminado: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
Opciones 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>
predeterminado:jpeg

Output image file format. Options: png, jpeg.

Opciones disponibles:
png,
jpeg

Respuesta

200 - application/json

Successful Response

​
created
integer
requerido

Unix timestamp (seconds) when the image was generated.

​
data
object[]
requerido

Array of generated image objects.

​
usage
object
requerido

Resource usage information for this request.

​
model
string

The model used for generation.