Modelos de imagemUsuários avançadosAtualizado em
POST/v1/images/generations

Console da API

POST/v1/images/generations
Ver chaves

As requisições usam a chave informada e seguem a cobrança padrão da API.

GPT Image 2.6 Flare

ID da solicitação gpt-image-2.6-flare

Protocolos

Autenticação

Obtenha uma chave em Gerenciar chaves de API. Para requisições JSON, defina Content-Type: application/json.

  • Authorization: Bearer YOUR_API_KEY

Parâmetros da requisição

POST /v1/images/generations

CampoTipoObrigatórioDescrição
modelstringObrigatórioUse este ID de modelo gpt-image-2.6-flare.
promptstringObrigatórioDescreva a imagem a gerar.
sizestringCondicionalUse auto para GIF. Para imagens estáticas, defina aspect_ratio e image_size.
aspect_ratiostringCondicionalProporção da imagem de saída. Valores aceitos auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. Padrão auto. Para imagens estáticas. Omita em solicitações de GIF.
image_sizestringCondicionalFaixa de resolução da saída. Valores aceitos 1K, 2K, 4K. Quando omitido, o valor é calculado a partir de size. Padrão 1K. Para imagens estáticas. Omita em solicitações de GIF.
resolutionstringCondicionalAlias de resolução para imagens estáticas. Se usado com image_size, os valores devem ser iguais. Para imagens estáticas. Omita em solicitações de GIF.
output_formatstringOpcionalpng gera uma imagem estática e gif gera uma animação. Para GIF, use size: "auto" e n: 1. Os quadros são ajustados automaticamente. Padrão png.
backgroundstringOpcionalO fundo é tratado automaticamente. Valores aceitos auto.
qualitystringOpcionalConfiguração da qualidade de geração. Valores aceitos auto, low, medium, high. Padrão auto.
nintegerOpcionalUma imagem por solicitação. Padrão 1.
image_urlsstring[]OpcionalLista JSON de imagens de referência. Cada item é uma URL HTTPS pública ou uma URL de dados de imagem em Base64. Também aceita image_input. Máximo de imagens de referência 8. Use referências em PNG, JPEG ou WebP para imagens estáticas de 2K ou 4K.
?asyncstringOpcionalParâmetro de consulta da URL. Use 1, true ou yes para receber 202 e task_id. Omita para aguardar o resultado.

POST /v1/images/edits

CampoTipoObrigatórioDescrição
modelstringObrigatórioUse este ID de modelo gpt-image-2.6-flare.
promptstringObrigatórioDescreva as alterações na imagem de referência.
aspect_ratiostringOpcionalProporção da imagem de saída. Valores aceitos auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. Padrão auto.
image_sizestringOpcionalFaixa de resolução da saída. Valores aceitos 1K, 2K, 4K. Quando omitido, o valor é calculado a partir de size. Padrão 1K.
resolutionstringOpcionalAlias de resolução para imagens estáticas. Se usado com image_size, os valores devem ser iguais.
output_formatstringOpcionalA imagem editada é retornada em PNG. Padrão png.
backgroundstringOpcionalO fundo é tratado automaticamente. Valores aceitos auto.
qualitystringOpcionalConfiguração da qualidade de geração. Valores aceitos auto, low, medium, high. Padrão auto.
nintegerOpcionalUma imagem por solicitação. Padrão 1.
image_urlsstring[]CondicionalLista JSON de imagens de referência. Cada item é uma URL HTTPS pública ou uma URL de dados de imagem em Base64. Também aceita image_input. Máximo de imagens de referência 8. Inclua ao menos uma referência em edições via JSON. Use referências em PNG, JPEG ou WebP para imagens estáticas de 2K ou 4K.
image[]file[]CondicionalPara edições com multipart/form-data, envie ao menos uma imagem. Repita o campo para várias imagens. Para um único arquivo, também é possível usar image. Máximo de imagens de referência 8. Use referências em PNG, JPEG ou WebP para imagens estáticas de 2K ou 4K.
?asyncstringOpcionalParâmetro de consulta da URL. Use 1, true ou yes para receber 202 e task_id. Omita para aguardar o resultado.

Exemplos de requisição

Defina a chave de API na variável de ambiente local ICODEEASY_API_KEY e escolha um endpoint que aceite chamadas HTTP diretas. Caso o endpoint exija um cliente específico, siga o guia de configuração desse cliente.

Substitua as URLs e os IDs de mídia dos exemplos por ativos válidos.

Images Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "A watercolor illustration of a paper lantern by a lake.",
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

Images Generations · Gerar um GIF

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "A paper lantern sways gently in a seamless loop.",
  "output_format": "gif",
  "size": "auto",
  "n": 1
}'

Images Generations · Gerar GIF com imagem de referência

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "Animate the lantern in the reference image in a seamless loop while preserving the composition.",
  "output_format": "gif",
  "size": "auto",
  "n": 1,
  "image_urls": [
    "https://example.com/reference.png"
  ]
}'

Images Edits

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/edits' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-flare",
  "prompt": "Change the background to a pale blue wall. Preserve the subject.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

Consultar tarefa de imagem

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

Respostas e tarefas

HTTP 200 · Sucesso síncrono

Com ?sync=1, leia as URLs geradas em data[].url. created é um timestamp Unix em segundos e id é o ID da tarefa.

json
{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · Envio assíncrono

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

Com ?async=1, consulte GET /v1/images/tasks/{task_id} com a mesma chave de API. status é pending, completed ou failed. Quando a tarefa concluir, leia a URL da imagem em result_url.

HTTP 200 · Consulta de tarefa concluída

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "gpt-image-2.6-flare",
  "result_url": "https://example.com/generated-image.png"
}

Erros comuns

Se a consulta retornar failed, leia error. Se houver error_detail, confira retryable antes de enviar novamente.

Exemplos de resposta e erros

Guia completo de integração · Consulte o guia completo da API para ver os campos, estados de tarefas e formatos de resposta.

Recursos e limites

  • text_to_image · Compatível
  • image_to_image · Compatível
  • image_editing · Compatível
  • reference_images · Condicional — Requer imagens de referência válidas em um formato de solicitação compatível
  • Limites Imagens de referência: até 8 · Resoluções: 1K, 2K, 4K · Entrada: Static PNG or animated GIF. GIF uses size: auto and n: 1. Static 2K/4K reference images must be PNG, JPEG, or WebP.

Catálogo de recursos dos modelos · Ver preços

Guias relacionados

API de geração de imagens

Gere ou edite imagens com a API compatível com OpenAI. Envie prompts, dimensões e imagens de referência e consulte os resultados ou o status das tarefas assíncronas.

Catálogo de recursos dos modelos

Compare modelos públicos de texto, imagem e vídeo por ID normalizado, protocolos, clientes, ferramentas, recursos de mídia, limites e data de revisão.

Criar conta e obter uma API Key