Saltar para o conteúdo principal
POST
/
v1
/
images
/
generations
Create images
curl --request POST \
  --url https://api.cometapi.com/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "dall-e-3",
  "prompt": "A paper boat floating on calm water at sunrise."
}
'
{
  "created": 1773311889,
  "data": [
    {
      "revised_prompt": "A paper boat floating on calm water at sunrise, with soft golden light reflecting off the water's surface.",
      "url": "https://filesystem.site/cdn/20260312/1d6826050921c07a13ff173310c640.webp"
    }
  ]
}
Use esta rota para criar imagens a partir de texto com formatos de requisição compatíveis com OpenAI no CometAPI.

​
Escolha um model primeiro

  • Use dall-e-3 quando quiser um teste simples baseado em URL
  • Use gpt-image-1, gpt-image-1-mini ou gpt-image-1.5 quando quiser modelos de imagem GPT mais novos e puder lidar com respostas em base64
  • 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 um prompt e uma imagem antes de adicionar geração em lote ou ajuste de estilo

​
Comportamento de resposta específico por model

  • dall-e-2 e dall-e-3 oferecem suporte a respostas por URL e respostas em base64
  • gpt-image-1, gpt-image-1-mini e gpt-image-1.5 são melhor tratados como rotas baseadas primeiro em base64
  • qwen-image não oferece suporte a n > 1
Durante a validação em ambiente real em 2026-03-12, uma requisição para dall-e-3 com response_format: "url" retornou um timestamp created normal, um revised_prompt e uma URL temporária da imagem.
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.

​
size
string

Requested output size. Supported values depend on the selected model.

Exemplo:

"1024x1024"

​
response_format
enum<string>

Requested output encoding for models that support it.

Opções disponíveis:
url,
b64_json

Resposta

200 - application/json

Image generation result.

​
created
integer
obrigatório

Unix timestamp for the completed generation.

​
data
object[]
obrigatório