Referência para desenvolvedores

Documentação da API GPT Image 2.6

Crie uma chave de API, envie uma solicitação de geração e consulte a tarefa para obter sua imagem.

Crie sua chave de API

Entre na sua conta e crie uma chave. Antes de executar os exemplos, defina GPT_IMAGE_API_KEY com essa chave no ambiente do seu servidor.

Gerenciar chaves de API

Mantenha a chave no seu servidor. Os dois endpoints usam sua chave de API de usuário via Authorization: Bearer e não exigem cookies do navegador.

As solicitações de geração usam créditos da sua conta. Com as mesmas configurações, Flare e Sunburst têm o mesmo custo em créditos. Ver os custos atuais

Envie uma solicitação de geração

POST /api/generate

Salve o JSON abaixo como request.json. Este exemplo cria uma imagem a partir de texto. Para editar com imagens de referência, adicione o array images descrito a seguir.

Corpo da solicitação: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "Uma xícara de cerâmica azul sobre uma mesa de madeira, com um fundo de papel em tons quentes.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

Enviar pelo seu servidor

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

Uma solicitação aceita retorna code 200, data.task_id, data.status definido como IN_PROGRESS e data.consumed_credits. Salve data.task_id para consultar o status.

Campos da solicitação

Campo	Significado e valores aceitos
`model`	Use gpt-image-2.6. Esse também é o valor padrão quando o campo é omitido.
`variant`	Opcional: flare, sunburst. Padrão: flare. Defina sunburst para usar Sunburst.
`prompt`	Texto obrigatório, de 1 a 20000 caracteres após remover espaços no início e no fim.
`quality`	Opcional: low, medium, high, xhigh, max. Padrão: medium.
`resolution`	Opcional: 1k, 2k, 4k. Padrão: 1k.
`complexity`	Planejamento da composição, opcional: low, medium, high. Padrão: high.
`output_format`	Opcional: png, jpeg, webp. Padrão: png.
`images`	Array opcional com até 16 URLs de imagens HTTP(S). Ao incluir ao menos uma referência, o modo de edição é ativado; omita este campo para gerar a partir de texto.

Consulte a tarefa

GET /api/status

Defina TASK_ID com o data.task_id recebido. Envie-o como parâmetro de consulta task_id com a mesma chave de API de usuário.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: A tarefa ainda está em andamento. Consulte este endpoint novamente para verificar o progresso.
SUCCESS: Obtenha as URLs das imagens geradas no array data.response.
FAILED: Leia os detalhes da falha em data.error_message antes de decidir se envia outra solicitação.

Exemplo de uma tarefa concluída

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

Os valores entre sinais de menor e maior representam o ID da tarefa e a URL da imagem retornados pela sua solicitação.