Saltar para o conteúdo principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1776841943,
  "background": "opaque",
  "output_format": "jpeg",
  "quality": "low",
  "size": "1024x1024",
  "usage": {
    "input_tokens": 16,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 16
    },
    "output_tokens": 208,
    "total_tokens": 224
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Referência oficial

​
Escolha um modelo primeiro

  • Use dall-e-3 quando quiser uma primeira requisição simples com response_format
  • Use um modelo de imagem GPT quando precisar de controles exclusivos do GPT, como output_format, quality ou background
  • Use qwen-image quando precisar especificamente desse provedor, mas mantenha n em 1

​
Primeira requisição segura

  • Comece com dall-e-3
  • Mantenha size em 1024x1024
  • Defina response_format: "url" se quiser uma resposta JSON pequena e uma URL temporária para download
  • Use o exemplo de requisição GPT validado na referência da API se precisar de parâmetros de modelo de imagem GPT
  • Adicione output_format somente quando precisar de um tipo de imagem codificada específico, como jpeg
  • Verifique o guia de geração de imagens da OpenAI antes de adicionar background, output_compression ou streaming
  • Use um Prompt e uma imagem de saída antes de adicionar geração em lote ou ajuste de estilo

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

  • response_format se aplica a dall-e-2 e dall-e-3
  • Modelos de imagem GPT usam controles exclusivos do GPT, como output_format, quality, background e output_compression
  • Siga o guia de geração de imagens da OpenAI para as opções específicas de modelo mais recentes
  • qwen-image não oferece suporte a n > 1
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:dall-e-3
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."

​
n
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. 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.

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"

Resposta

200 - application/json

Image generation result.

​
created
integer
obrigatório

Unix timestamp for the completed generation.

​
usage
object
obrigatório
​
data
object[]
obrigatório
​
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.