Criar uma imagem

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..."
    }
  ]
}

Use esta rota para criar imagens a partir de texto com formatos de solicitação compatíveis com OpenAI no CometAPI.

Referência oficial

Leia o guia de geração de imagens da OpenAI antes de depender de controles específicos do modelo, como background, output_compression, streaming ou futuras opções de imagem GPT.
Use a referência Create image da OpenAI para consultar a lista atual de parâmetros.

Escolha primeiro um modelo

Use um modelo de imagem GPT, como gpt-image-2, para solicitações de texto para imagem com controles como output_format, quality ou background
Use gpt-image-2.5-sunburst ou gpt-image-2.5-flare quando precisar de fundos transparentes ou dos níveis de qualidade xhigh e max
Use qwen-image quando precisar especificamente desse provedor, mas mantenha n em 1
Escolha um ID de modelo de imagem atual na página de modelos

Primeira solicitação segura

Comece com gpt-image-2
Mantenha size em 1024x1024
Os modelos de imagem GPT retornam dados de imagem codificados em base64 em b64_json; decodifique-os para salvar o arquivo de imagem
Adicione output_format somente quando precisar de um tipo específico de imagem codificada, como jpeg
Use um Prompt e uma imagem de saída antes de adicionar geração em lote ou ajuste de estilo

Execute uma tarefa de imagem assíncrona

Use async: true para trabalhos de imagem de longa duração quando seu cliente preferir um fluxo de envio e consulta em vez de manter uma conexão HTTP aberta. A solicitação de criação retorna data.task_id. Consulte uma tarefa de geração de imagem até que data.status seja success ou failure. O campo async é uma extensão do CometAPI para esta rota, não um parâmetro da OpenAI. A OpenAI documenta stream e partial_images para modelos de imagem GPT. O modo de tarefa assíncrona do CometAPI retorna metadados de tarefa JSON e usa consulta. Use o modo de tarefa assíncrona com estes IDs de modelo documentados: gpt-image-2 e doubao-seedream-4-0-250828. Para outros modelos de imagem, use geração síncrona ou streaming, a menos que o suporte a tarefas assíncronas esteja documentado para esse modelo. Quando uma solicitação inclui async: true e stream: true, o modo de tarefa assíncrona tem precedência. A solicitação de criação retorna metadados de tarefa JSON em vez de um fluxo SSE.

Comportamento de solicitação específico do modelo

response_format aplica-se somente a modelos DALL·E; os modelos de imagem GPT retornam dados base64 e o ignoram
Os modelos de imagem GPT usam controles GPT-only, como output_format, quality, background e output_compression
quality aceita low, medium, high e auto em modelos de imagem GPT; gpt-image-2.5-sunburst e gpt-image-2.5-flare também aceitam xhigh e max
output_compression aplica-se quando output_format é webp ou jpeg; não tem efeito sobre png
partial_images aplica-se somente quando stream é true
Siga o guia de geração de imagens da OpenAI para conhecer as opções mais recentes específicas do modelo
qwen-image não oferece suporte a n > 1

Gerar um fundo transparente

Defina background como transparent para gerar um objeto isolado sem preenchimento de fundo. Isso é compatível com gpt-image-2.5-sunburst e gpt-image-2.5-flare. A transparência exige um formato de saída com um canal alfa. Defina output_format como png ou webp. JPEG não tem canal alfa, portanto uma solicitação transparente com output_format: "jpeg" é rejeitada. A resposta retorna dados de imagem em base64 em b64_json com um canal alfa. Decodifique-os para salvar o arquivo:

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))

Defina background como opaque para forçar um fundo sólido ou como auto para permitir que o modelo decida. A resposta repete o valor aplicado no campo background de nível superior.

As imagens geradas devem estar em conformidade com as políticas de uso do provedor. Não envie prompts ilegais, violentos, pornográficos ou que infrinjam direitos autorais.

Autorizações

Authorization

string

header

obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

model

string

padrão:gpt-image-2

obrigatório

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

prompt

string

obrigatório

Text description of the image you want to generate.

Exemplo:

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

integer

padrão: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.

Exemplo:

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

Opções disponíveis:

transparent,

opaque,

auto

output_compression

integer

padrão: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.

Intervalo necessário: 0 <= x <= 100

moderation

enum<string>

padrão:auto

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

Opções disponíveis:

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.

Intervalo necessário: 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.

Exemplo:

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

Opções disponíveis:

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.

Exemplo:

"jpeg"

stream

boolean

padrão: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

padrão: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.

Resposta

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

obrigatório

Unix timestamp for the completed generation.

data

object[]

obrigatório

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 modificação em 11 de setembro 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..."
    }
  ]
}

Moderação de conteúdo

Chaves de API

Referência oficial

Escolha primeiro um modelo

Primeira solicitação segura

Execute uma tarefa de imagem assíncrona

Comportamento de solicitação específico do modelo

Gerar um fundo transparente

Autorizações

Corpo

Resposta

​Referência oficial

​Escolha primeiro um modelo

​Primeira solicitação segura

​Execute uma tarefa de imagem assíncrona

​Comportamento de solicitação específico do modelo

​Gerar um fundo transparente

Autorizações

Corpo

Resposta

Referência oficial

Escolha primeiro um modelo

Primeira solicitação segura

Execute uma tarefa de imagem assíncrona

Comportamento de solicitação específico do modelo

Gerar um fundo transparente