Descripción general
Referencia de la API
Guías de integración
Errores
Precios y facturación
Generación de Imágenes Seedream
Usa CometAPI POST /v1/images/generations para la generación de texto a imagen e imagen a imagen con Seedream; admite salida secuencial de múltiples imágenes e imágenes de referencia.
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>"
}Resumen
Genera imágenes con los modelos Seedream de ByteDance a través del endpoint estándar compatible con OpenAI/v1/images/generations. Admite tanto la generación de texto a imagen como de imagen a imagen.
Para ver la lista completa de modelos, consulta la página de Modelos. Para consultar la documentación detallada de parámetros del proveedor, revisa la documentación de VolcEngine.
sequential_image_generation en auto y, opcionalmente, 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 imágenes generadas debe ser ≤ 15.Imagen a imagen
Pasa una o más imágenes de referencia mediante el parámetroimage (arreglo de URL o data URI base64) junto con un prompt de texto. Admite hasta 14 imágenes de referencia.
¿La URL devuelta muestra AccessDenied?
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 da como resultado:
\{"Code":"AccessDenied","Message":"Access Denied","EC":"0003-00000015"\}
- curl: pásalo por
| jq -r '.data[].url'para extraer la URL correctamente. - Python: usa
result.data[0].urloimage["url"]— la cadena ya está completa; pásala directamente arequests.get()owebbrowser.open(). - JavaScript: la misma idea —
result.data[0].url. - General: asegúrate de que
&y%en la URL no se truncuen ni se escapen dos veces.
Autorizaciones
Bearer token authentication. Use your CometAPI key.
Cuerpo
Parameters for Seedream image generation (text-to-image and image-to-image).
Model to use. See the Models page for current Seedream model IDs.
Text prompt describing the image to generate. Supports both Chinese and English. Recommended max 300 Chinese characters or 1000 English characters.
Output format. url returns a temporary image link (valid for 24 hours); b64_json returns base64-encoded image data.
url, b64_json Output resolution. Presets 2K, 4K, or exact pixels like 2048x2048, 2304x1728, 2848x1600, 1600x2848, etc. Default: 2048x2048.
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.
When true, adds an 'AI Generated' watermark to the bottom-right corner of the output image.
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).
Random seed for reproducible outputs. Range: -1 to 2147483647. Use -1 (default) for random generation. Legacy parameter — ignored by newer models.
Controls sequential (multi-image) generation mode.
auto: model decides whether to generate a sequence based on the promptdisabled: always generate a single image
auto, disabled Configuration for sequential (multi-image) generation. Only effective when sequential_image_generation is auto.
Show child attributes
Show child attributes
Output image file format. Options: png, jpeg.
png, jpeg Respuesta
Successful Response
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>"
}