Guia da API GPT-Image-2

GPT-Image-2 — API de geração de imagens da OpenAI

Acesse o model de geração de imagens mais recente da OpenAI por meio da API unificada do TokenHub. Totalmente OpenAI-compatible, com resposta síncrona (sem necessidade de polling), vários tamanhos até 4K, níveis de qualidade e formatos de saída PNG/JPEG/WebP. Suporta tanto text-to-image (t2i) quanto edição image-to-image (i2i, composição com múltiplas imagens e inpainting). Este guia mostra a integração completa.

Text → ImageImage → Image (i2i)OpenAI-CompatibleSynchronousUp to 4KToken-based

1Obtenha sua API Key

Visite tokenhub.store para criar uma conta (login com GitHub / Google suportado)
Vá para Dashboard → API Keys e clique em "Create New Key"
Vá para Dashboard → Billing para adicionar Credits (1 Credit = US$1)
Copie sua API Key (formato: th-xxxxxxxxxxxx...)

⚠️ A API Key é exibida apenas uma vez na criação. Guarde-a com segurança. Se perdê-la, será necessário criar uma nova.

2Visão geral da API

Base URL

https://tokenhub.store/api/v1

Autenticação

Todas as requisições exigem uma API Key no cabeçalho:

Header

Authorization: Bearer th-your-api-key

Endpoints (sincrônicos, OpenAI-compatible)

POST

/images/generations

Text-to-image. Gere imagens a partir de um prompt de texto.

POST

/images/edits

Edição image-to-image. Suporta edições de imagem única, composição com múltiplas imagens e inpainting opcional com uma máscara.

3Preços

Tier	Preço	Faixa de resolução
1K	$0.125 / image	Lado mais longo ≤ 1536 px (ex.: 1024×1024, 1024×1536)
2K	$0.250 / image	Lado mais longo ≤ 2048 px (ex.: 2048×2048)
4K	$0.500 / image	Maior lado > 2048 px (por exemplo, 4096×4096)

Preço fixo por imagem com base na faixa de resolução de saída (determinada pelo maior lado do tamanho). n imagens = preço unitário × n. Chamadas com falha não são cobradas.

Mapeamento de faixa pelo maior lado: ≤ 1536 px → 1K ($0.125), ≤ 2048 px → 2K ($0.250), > 2048 px → 4K ($0.500). Exemplos: 1024×1024 e 1024×1536 são ambos 1K; 2048×2048 é 2K; 4096×4096 é 4K.

4Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
model	string	Obrigatório	—	ID do modelo. Use "openai/gpt-image-2" (ou a forma curta "gpt-image-2").
prompt	string	Obrigatório	—	Prompt de texto descrevendo a imagem a ser gerada.
n	integer	Opcional	1	Número de imagens a gerar (1–10).
size	string	Opcional	1024x1024	Dimensões de saída. Opções: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840, auto.
quality	string	Opcional	auto	Qualidade de geração. Opções: auto, low, medium, high. Qualidade mais alta consome mais Tokens.
format	string	Opcional	png	Formato da imagem de saída. Opções: png, jpeg, webp.

Campos adicionais para /images/edits (i2i)

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
image	file / string \| array	Obrigatório	—	Imagem(ns) de entrada para editar. Aceita arquivo(s) via multipart, ou URL / data URI em base64 no JSON. Forneça várias para compô-las em uma única saída.
mask	file / string	Opcional	—	Máscara opcional de inpainting. As áreas transparentes serão regeneradas; as áreas opacas serão preservadas.
input_fidelity	string	Opcional	low	Quão fielmente preservar a entrada. Opções: low, high. Use high para manter identidade/layout; use low para transformações mais ousadas.
output_format	string	Opcional	png	Alias de 'format' para o endpoint de edição. Opções: png, jpeg, webp.
output_compression	integer	Opcional	100	Nível de compressão 0–100 (apenas para jpeg / webp).

5Exemplo completo em curl

bash

curl -X POST https://tokenhub.store/api/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-2",
    "prompt": "A serene Japanese garden at sunset, koi pond reflections, cherry blossoms, soft cinematic lighting, ultra-detailed"
  }'

Resposta:

json

{
  "created": 1740000000,
  "data": [
    {
      "url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

6Exemplo completo em Python

python

# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://tokenhub.store/api/v1",
)

result = client.images.generate(
    model="openai/gpt-image-2",
    prompt="A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
    n=1,
    size="1536x1024",
    quality="high",
)

image_url = result.data[0].url
print("Image URL:", image_url[:80], "...")

7Exemplo completo em JavaScript / Node.js

javascript

// npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://tokenhub.store/api/v1",
});

const result = await client.images.generate({
  model: "openai/gpt-image-2",
  prompt: "A majestic dragon flying over snowy mountains at dawn, epic fantasy art, ultra-detailed",
  n: 1,
  size: "1536x1024",
  quality: "high",
});

console.log("Image URL:", result.data[0].url.slice(0, 80), "...");

8Dicas de uso

Prompts em inglês geralmente produzem os melhores resultados; chinês também é suportado.
Os dados de response[].url podem ser uma URL https simples ou um data URI (base64). Trate ambos os casos ao salvar em disco.
Para reduzir o custo, use qualidade low/medium para rascunhos e use tamanhos high/4K apenas para a saída final.
O endpoint é síncrono — sem task id, sem polling. Uma requisição normalmente é concluída em 5–30 segundos, dependendo do tamanho e da qualidade.
Defina o timeout HTTP para ≥ 120s no lado do cliente para evitar desconexão prematura em imagens grandes.

9FAQ

Pronto para começar?

Cadastre-se no TokenHub e comece a usar a API do GPT-Image-2 agora

Obter API Key Adicionar Credits