Crear una imagen

POST

images

generations

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Usa esta ruta para crear imágenes a partir de texto con formatos de solicitud compatibles con OpenAI en CometAPI.

Referencia oficial

Lee la guía de generación de imágenes de OpenAI antes de depender de controles específicos del modelo como background, output_compression, streaming o futuras opciones de imagen de GPT.
Usa la referencia Create image de OpenAI para la lista actual de parámetros.

Elige primero un modelo

Usa un modelo de imagen GPT como gpt-image-2 para solicitudes de texto a imagen con controles como output_format, quality o background
Usa qwen-image cuando necesites específicamente ese proveedor, pero mantén n en 1
Elige un model ID de imagen actual desde la página Models

Primera solicitud segura

Empieza con gpt-image-2
Mantén size en 1024x1024
Los modelos de imagen GPT devuelven datos de imagen codificados en base64 en b64_json; decodifícalos para guardar el archivo de imagen
Agrega output_format solo cuando necesites un tipo de imagen codificada específico como jpeg
Revisa la guía de generación de imágenes de OpenAI antes de agregar background, output_compression o streaming
Usa un prompt y una imagen de salida antes de agregar generación por lotes o ajuste de estilo

Ejecutar una tarea de imagen asíncrona

Usa async: true para trabajos de imagen de larga duración cuando tu cliente prefiera un flujo de envío y consulta en lugar de mantener abierta una conexión HTTP. La solicitud de creación devuelve data.task_id. Consulta Retrieve an image generation task hasta que data.status sea success o failure. El campo async es una extensión de CometAPI para esta ruta, no un parámetro de OpenAI. OpenAI documenta stream y partial_images para los modelos de imagen GPT. El modo de tarea asíncrona de CometAPI devuelve metadatos de tarea en JSON y usa sondeo. Usa el modo de tarea asíncrona con estos model IDs documentados: gpt-image-2 y doubao-seedream-4-0-250828. Para otros modelos de imagen, usa generación síncrona o streaming, a menos que la compatibilidad con tareas asíncronas esté documentada para ese modelo. Cuando una solicitud incluye tanto async: true como stream: true, el modo de tarea asíncrona tiene prioridad. La solicitud de creación devuelve metadatos de tarea en JSON en lugar de un flujo SSE.

Comportamiento de solicitud específico del modelo

response_format se aplica solo a los modelos DALL·E; los modelos de imagen GPT devuelven datos base64 y lo ignoran
Los modelos de imagen GPT usan controles exclusivos de GPT como output_format, quality, background y output_compression
Sigue la guía de generación de imágenes de OpenAI para conocer las opciones específicas del modelo más recientes
qwen-image no admite n > 1

Las imágenes generadas deben cumplir con las políticas de uso del proveedor. No envíes prompts ilegales, violentos, pornográficos ni que infrinjan derechos de autor.

Autorizaciones

Authorization

string

header

requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

model

string

predeterminado:gpt-image-2

requerido

The image generation model to use. Choose a current model from the Models page.

prompt

string

requerido

Text description of the image you want to generate.

Ejemplo:

"A paper boat floating on calm water at sunrise."

integer

predeterminado:1

Number of images to generate. Keep this at 1 for the broadest compatibility.

quality

string

Quality setting for models that support it. See the OpenAI image generation guide for the latest model-specific values.

size

string

Requested output size. Supported values depend on the selected model. See the OpenAI image generation guide for the latest model-specific ranges.

Ejemplo:

"1024x1024"

response_format

enum<string>

The response container for dall-e-2 and dall-e-3. This parameter is not supported for GPT image models, which return base64-encoded image data.

Opciones disponibles:

url,

b64_json

output_format

string

The encoded image type for GPT image model results, such as png, jpeg, or webp. See the OpenAI image generation guide for current GPT image output controls.

Ejemplo:

"jpeg"

stream

boolean

predeterminado:false

Set this to true to receive server-sent image generation events instead of waiting for the completed JSON response. Streaming responses use text/event-stream and can include final events such as image_generation.completed. When stream and async are both true, async task mode takes precedence and the create request returns JSON instead of a streaming image response.

async

boolean

predeterminado:false

CometAPI asynchronous task mode. Set this to true to return immediately with data.task_id, then poll GET /v1/images/generations/{task_id} for the final image data. Documented model IDs for this mode: gpt-image-2 and doubao-seedream-4-0-250828. This is a CometAPI extension, not an OpenAI parameter. When async and stream are both true, async takes precedence and returns JSON task metadata instead of an SSE stream.

Respuesta

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

Completed image response
Async task response

created

integer

requerido

Unix timestamp for the completed generation.

data

object[]

requerido

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

usage

object

Token usage details when returned by the selected model.

Show child attributes

APIs de generación y edición de imágenes

Recuperar una tarea de generación de imágenes

curl https://api.cometapi.com/v1/images/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A paper boat floating on calm water at sunrise.",
    "quality": "low",
    "size": "1024x1024",
    "output_format": "jpeg"
  }'

{
  "created": 1781075000,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 13,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 13
    },
    "output_tokens": 196,
    "output_tokens_details": {
      "image_tokens": 196,
      "text_tokens": 0
    },
    "total_tokens": 209
  },
  "data": [
    {
      "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..."
    }
  ]
}

Moderación de contenido

Claves API

Referencia oficial

Elige primero un modelo

Primera solicitud segura

Ejecutar una tarea de imagen asíncrona

Comportamiento de solicitud específico del modelo

Autorizaciones

Cuerpo

Respuesta

​Referencia oficial

​Elige primero un modelo

​Primera solicitud segura

​Ejecutar una tarea de imagen asíncrona

​Comportamiento de solicitud específico del modelo

Autorizaciones

Cuerpo

Respuesta

Referencia oficial

Elige primero un modelo

Primera solicitud segura

Ejecutar una tarea de imagen asíncrona

Comportamiento de solicitud específico del modelo