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 u opciones futuras de imágenes GPT.
Usa la referencia de Create image de OpenAI para consultar la lista actual de parámetros.

Primero elige 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 gpt-image-2.5-sunburst o gpt-image-2.5-flare cuando necesites fondos transparentes o los niveles de calidad xhigh y max
Usa qwen-image cuando necesites específicamente ese proveedor, pero mantén n en 1
Elige un ID de modelo de imagen actual en la página de modelos

Primera solicitud segura

Comienza 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
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 sondeo en lugar de mantener abierta una conexión HTTP. La solicitud de creación devuelve data.task_id. Consulta una tarea de generación de imágenes 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 JSON y usa sondeo. Usa el modo de tarea asíncrona con estos ID de modelo documentados: gpt-image-2 y doubao-seedream-4-0-250828. Para otros modelos de imagen, usa generación síncrona o streaming, salvo que se documente compatibilidad con tareas asíncronas 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 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 de GPT-only como output_format, quality, background y output_compression
quality acepta low, medium, high y auto en modelos de imagen GPT; gpt-image-2.5-sunburst y gpt-image-2.5-flare también aceptan xhigh y max
output_compression se aplica cuando output_format es webp o jpeg; no tiene efecto en png
partial_images se aplica solo cuando stream es true
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

Generar un fondo transparente

Establece background en transparent para generar un sujeto aislado sin relleno de fondo. Esto es compatible con gpt-image-2.5-sunburst y gpt-image-2.5-flare. La transparencia requiere un formato de salida con canal alfa. Establece output_format en png o webp. JPEG no tiene canal alfa, por lo que se rechaza una solicitud transparente con output_format: "jpeg". La respuesta devuelve datos de imagen base64 en b64_json con un canal alfa. Decodifícalos para guardar el archivo:

import base64
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cometapi.com/v1",
    api_key=os.environ["COMETAPI_KEY"],
)

result = client.images.generate(
    model="gpt-image-2.5-sunburst",
    prompt="A single red apple, centered, isolated subject.",
    quality="low",
    size="1024x1024",
    background="transparent",
    output_format="png",
)

with open("apple.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Establece background en opaque para forzar un fondo sólido, o en auto para permitir que el modelo decida. La respuesta repite el valor aplicado en el campo background de nivel superior.

Las imágenes generadas deben cumplir las políticas de uso del proveedor. No envíes prompts ilegales, violentos, pornográficos o 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. GPT image models accept low, medium, high, and auto. gpt-image-2.5-sunburst and gpt-image-2.5-flare also accept xhigh and max. dall-e-3 accepts standard and hd. See the OpenAI image generation guide for the latest model-specific values.

Ejemplo:

"low"

background

enum<string>

Background mode for the generated image. Set transparent to generate an isolated subject with no background fill; this requires output_format set to png or webp, and returns an error with jpeg. Set opaque for a solid background, or auto to let the model decide. Supported on gpt-image-2.5-sunburst and gpt-image-2.5-flare.

Opciones disponibles:

transparent,

opaque,

auto

output_compression

integer

predeterminado:100

Compression level for the output image, from 0 to 100. Applies when output_format is webp or jpeg. Lower values produce smaller files with more compression artifacts.

Rango requerido: 0 <= x <= 100

moderation

enum<string>

predeterminado:auto

Content moderation level for GPT image models. low is less restrictive; auto is the default.

Opciones disponibles:

low,

auto

partial_images

integer

Number of partial images to emit while a streaming response is in progress, from 0 to 3. Each partial image arrives as an image_generation.partial_image event before the final image_generation.completed event. Applies when stream is true.

Rango requerido: 0 <= x <= 3

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

Última modificación el 11 de septiembre de 2026

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

Primero elige un modelo

Primera solicitud segura

Ejecutar una tarea de imagen asíncrona

Comportamiento de solicitud específico del modelo

Generar un fondo transparente

Autorizaciones

Cuerpo

Respuesta

​Referencia oficial

​Primero elige un modelo

​Primera solicitud segura

​Ejecutar una tarea de imagen asíncrona

​Comportamiento de solicitud específico del modelo

​Generar un fondo transparente

Autorizaciones

Cuerpo

Respuesta

Referencia oficial

Primero elige un modelo

Primera solicitud segura

Ejecutar una tarea de imagen asíncrona

Comportamiento de solicitud específico del modelo

Generar un fondo transparente