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

ID da solicitação gpt-image-2

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.
promptstringObrigatórioDescreva a imagem a gerar.
sizestringOpcionalPrefira dimensões em pixels, como 1536x1024. A requisição também aceita auto ou proporções como 16:9. O tratamento da proporção pode variar conforme o endpoint. Padrão 1024x1024.
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.
qualitystringOpcionalConfiguração da qualidade de geração. Valores aceitos auto, low, medium, high.
nintegerOpcionalQuantidade de imagens por solicitação. Use 1 para obter um resultado. 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 4.
?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.
promptstringObrigatórioDescreva as alterações na imagem de referência.
sizestringOpcionalPrefira dimensões em pixels, como 1536x1024. A requisição também aceita auto ou proporções como 16:9. O tratamento da proporção pode variar conforme o endpoint. Padrão 1024x1024.
image_sizestringOpcionalFaixa de resolução da saída. Valores aceitos 1K, 2K, 4K. Quando omitido, o valor é calculado a partir de size. Para edições, defina este campo no corpo JSON. Padrão 1K.
qualitystringOpcionalConfiguração da qualidade de geração. Valores aceitos auto, low, medium, high.
nintegerOpcionalQuantidade de imagens por solicitação. Use 1 para obter um resultado. 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 4. Inclua ao menos uma referência em edições via JSON.
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 4.
?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",
  "prompt": "A watercolor illustration of a paper lantern by a lake.",
  "size": "1536x1024",
  "image_size": "1K"
}'

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",
  "prompt": "Change the background to a pale blue wall. Preserve the subject.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "size": "1536x1024",
  "image_size": "1K"
}'

Images Edits · Enviar e editar imagem

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/edits' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -F 'model=gpt-image-2' \
  -F 'prompt=Change the background to a pale blue wall. Preserve the subject.' \
  -F 'size=1536x1024' \
  -F 'image[]=@/path/to/photo.png'

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",
  "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é 4 · Resoluções: 1k, 2k, 4k

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