Crear imágenes de Seedream

POST

images

generations

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Usa la ruta compatible con OpenAI POST /v1/images/generations de CometAPI para ejecutar la generación de imágenes con Seedream. Este endpoint admite prompts de texto a imagen, solicitudes con imágenes de referencia y salida secuencial acotada de imágenes cuando el modelo seleccionado admite esos controles. Esta página cubre seedream-5-0-pro-260628 para solicitudes Pro de texto a imagen y seedream-5-0-260128 para ejemplos de imágenes de referencia, secuenciales y async de Seedream 5.0. Para consultar la disponibilidad en tu cuenta, consulta la página de modelos o realiza una consulta a /v1/models. Para obtener detalles sobre los parámetros del proveedor, consulta la API de generación de imágenes de BytePlus y el tutorial de Seedream 4.0-5.0.

Elige una forma de solicitud

Texto a imagen: envía model, prompt, size y controles de salida opcionales como response_format, output_format y watermark.
Imagen a imagen: agrega image como un arreglo de URL HTTPS públicas o URI de datos. Usa un arreglo incluso cuando envíes una sola imagen de referencia.
Prompt secuencial: establece sequential_image_generation en auto y usa sequential_image_generation_options.max_images como límite superior. El modelo puede devolver menos imágenes que el máximo.
Tarea async: agrega async: true cuando quieras que la solicitud de creación devuelva data.task_id en lugar de mantener abierta la conexión HTTP.

Las imágenes de referencia más las imágenes generadas deben mantenerse dentro del límite del proveedor. Mantén acotadas las solicitudes secuenciales con max_images.

Ejecuta una tarea de imagen async

Establece async en true para trabajos de imagen que tu cliente deba enviar y consultar. La solicitud de creación devuelve data.task_id; usa ese valor con Recuperar una tarea de imagen de Seedream hasta que data.status sea success o failure. Usa 2K en los ejemplos async para solicitudes de Seedream 5.0. La compatibilidad de tamaños varía según el model ID, así que elige un tamaño compatible con el modelo antes de enviar una tarea async.

Envía imágenes de referencia

Usa data:image/png;base64,YOUR_BASE64_IMAGE para datos de imagen en línea, o usa una URL HTTPS pública que el proveedor pueda recuperar. Los ejemplos de la referencia de la API muestran la forma JSON completa para cada tipo de solicitud.

Lee las URL de salida

La url devuelta es un enlace firmado de almacenamiento de objetos y puede contener &, % y otros caracteres especiales. Extrae la URL del JSON ya analizado en lugar de copiar una línea parcial de la terminal. En los ejemplos de shell, jq -r '.data[]?.url' conserva la URL firmada completa.

Autorizaciones

Authorization

string

header

requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

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

model

string

predeterminado:seedream-5-0-pro-260628

requerido

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

prompt

string

predeterminado:A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.

requerido

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>

predeterminado:url

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

Opciones disponibles:

url,

b64_json

size

string

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

predeterminado:false

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

async

boolean

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

predeterminado:png

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

Opciones 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.

Rango requerido: 1 <= x <= 10

seed

integer

predeterminado:-1

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

Rango requerido: -1 <= x <= 2147483647

sequential_image_generation

enum<string>

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

Opciones disponibles:

auto,

disabled

sequential_image_generation_options

object

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

Show child attributes

Respuesta

200 - application/json

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

Option 1
Async task response

created

integer

requerido

Unix timestamp in seconds when the image response was created.

data

object[]

requerido

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

Show child attributes

usage

object

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

Show child attributes

Obtener una predicción de Replicate

Recuperar una tarea de imagen de Seedream

curl -s https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro-260628",
  "prompt": "A clean product-style render of a blue ceramic mug on a white table, soft studio lighting.",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}' | jq -r '.data[]? | .url // .b64_json'

{
  "created": 1781075000,
  "data": [
    {
      "url": "https://<provider-cdn>/<file_id>.png",
      "size": "2048x2048"
    }
  ],
  "usage": {
    "generated_images": 1,
    "total_tokens": 0
  }
}

Moderación de contenido

Claves API

Elige una forma de solicitud

Ejecuta una tarea de imagen async

Envía imágenes de referencia

Lee las URL de salida

Autorizaciones

Cuerpo

Respuesta

​Elige una forma de solicitud

​Ejecuta una tarea de imagen async

​Envía imágenes de referencia

​Lee las URL de salida

Autorizaciones

Cuerpo

Respuesta

Elige una forma de solicitud

Ejecuta una tarea de imagen async

Envía imágenes de referencia

Lee las URL de salida