Recursos para Desenvolvedores

Documentação da API GPT Image 1.5

Integre o modelo GPT Image 1.5 da OpenAI em suas aplicações. Suporte para geração de texto-para-imagem e imagem-para-imagem com uma API REST simples.

Autenticação

A API GPT Image 1.5 utiliza autenticação por Bearer Token. Passe sua Chave de API no cabeçalho da requisição.

Autenticação

Authorization: Bearer sk-your-api-key-here

Mantenha sua chave de API segura. Não a compartilhe em códigos do lado do cliente.

Preços

Tipo	Custo	Descrição
Texto para Imagem	10 Créditos	Gere imagens a partir de prompts de texto.
Imagem para Imagem	10 Créditos	Edite imagens existentes com prompts de texto.

Criar Tarefa

POSThttps://gptimage15.ai/api/generate

Geração Assíncrona

Preços

Cada solicitação de geração custa 10 Credits, independentemente de ser texto-para-imagem ou imagem-para-imagem.

Inicia uma tarefa de geração. A API retorna um task_id imediatamente, que você usa para consultar os resultados.

Parâmetros do Corpo

Parâmetro	Tipo	Obrigatório	Descrição
prompt	string	Obrigatório	A descrição em texto para a geração da imagem. Máximo de 2000 caracteres.
size	string	Opcional	Tamanho da imagem: 10241024, 10241536 ou 15361024. Padrão: 10241024
quality	string	Opcional	Qualidade da imagem: low, medium ou high. Padrão: medium
images	array	Opcional	Para o modo Imagem-para-Imagem. Array de URLs de imagens para editar.
input_fidelity	string	Opcional	Fidelidade à imagem de entrada: low ou high. Padrão: high. Apenas para imagem-para-imagem.
callback_url	string	Opcional	URL de Webhook para notificação de conclusão da tarefa.

Exemplos de Requisição

Text-to-Image (cURL)

curl -X POST https://gptimage15.ai/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape...",
    "size": "1536*1024",
    "quality": "high"
  }'

Image-to-Image (Edit Mode)

{
  "prompt": "Add a rainbow in the sky",
  "images": [
    "https://example.com/landscape.jpg"
  ],
  "input_fidelity": "high",
  "quality": "medium"
}

Resposta de Sucesso

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS"
  }
}

Resposta de Erro

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Verificar Status

GEThttps://gptimage15.ai/api/status

Consulte este endpoint para verificar o progresso da sua tarefa. Recomendamos consultar a cada 5-10 segundos.

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
task_id	string	O ID da tarefa recebido do endpoint de geração. Obrigatório

Valores de Status

PENDINGTarefa na fila

IN_PROGRESSEm processamento

SUCCESSConcluído

FAILEDOcorreu um erro

cURL

curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
  -H "Authorization: Bearer YOUR_API_KEY"

Resposta (Em Andamento)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Resposta (Concluída)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Resposta (Falhou)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Códigos de Erro

Código	Descrição
200	Sucesso
400	Bad Request - Parâmetros inválidos (prompt ausente, tamanho/qualidade inválidos, etc.)
401	Unauthorized - Chave de API ausente ou inválida
404	Not Found - O ID da tarefa não existe
500	Internal Server Error - Por favor, tente novamente ou entre em contato com o suporte

Precisa de Ajuda?

Confira nosso canal de suporte ou envie-nos um e-mail.

Contatar Suporte