Documentação da API do GPT Image Hub

Todos os endpoints v1, exceto a listagem de modelos, exigem uma chave API no cabeçalho Authorization. A chave bruta é mostrada uma vez no momento da criação; o servidor armazena apenas um hash.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

O endpoint de modelos retorna IDs de modelo, provedores, proporções suportadas, qualidades suportadas, limites de imagem de referência e créditos por imagem.

curl https://www.gptimagehub.com/api/v1/models

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

O endpoint de créditos retorna o saldo, o tipo de conta e a próxima expiração do crédito para o usuário que possui a chave API.

curl https://www.gptimagehub.com/api/v1/credits \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Por padrão, o endpoint de geração de imagens aguarda a conclusão. Defina async como true para receber um id de geração imediatamente e consultar /api/v1/generations/:generationId até obter o resultado. Os créditos são cobrados antes da geração no provedor e reembolsados automaticamente quando o provedor falha ou retorna menos imagens do que o solicitado.

Solicitação JSON

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a transparent perfume bottle on black marble",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

Tarefa assíncrona

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-hero-image" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1,
    "async": true
  }'

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "queued",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "created_at": "2026-04-30T08:00:00.000Z",
  "images": [],
  "usage": {
    "credits": 0,
    "credits_requested": 7
  },
  "poll_url": "https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id"
}

Solicitação de imagem de referência

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=Use the reference image and render it as a premium studio product shot" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1" \
  -F "reference_image=@./reference.png"

Resposta

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "succeeded",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "images": [
    {
      "id": "clx_image_id",
      "object": "image",
      "url": "https://cdn.example.com/generations/user/image.png",
      "created_at": "2026-04-30T08:00:00.000Z"
    }
  ],
  "usage": {
    "credits": 7
  },
  "balance": {
    "credits": 113,
    "account_type": "PRO",
    "next_expiration": null
  }
}

Use o id retornado pelo endpoint de geração para recuperar o log salvo e as URLs das imagens. As chaves API só podem ler gerações pertencentes ao mesmo usuário.

curl https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "error": {
    "message": "Invalid request body",
    "code": "invalidRequest"
  }
}

• A geração síncrona pode ser executada por até 800 segundos em produção.
• n deve estar entre 1 e 4.
• Imagens de referência suportam PNG, JPG, JPEG e WebP. A requisição inteira, incluindo todas as imagens de referência, deve ficar abaixo de 4.5MB (mantenha as imagens abaixo de 4MB no total). Requisições maiores são rejeitadas pela plataforma de hospedagem com um 413 em texto simples antes de chegarem à API, portanto redimensione ou comprima as imagens primeiro.
• A quantidade máxima de imagens de referência é definida pelo reference_image_limit de cada modelo.
• Limites de requisição: 60 requisições de geração por minuto por chave de API e 120 por minuto por endereço IP. Todas as respostas contêm os cabeçalhos RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset; um 429 também contém Retry-After.
• Para tentar novamente uma geração com segurança, envie um cabeçalho Idempotency-Key (até 120 caracteres). Repetir a mesma chave com a mesma chave de API retorna a geração original em vez de cobrar novamente.
• O modo assíncrono retorna 202 com poll_url. Webhooks ainda não estão disponíveis.