Início rápido
Gere sua primeira imagem com IA pela API do Cheapest Imagen em três passos: crie uma chave, envie uma requisição e leia a imagem na resposta.
A API usa as mesmas requisições e respostas da API de Imagens da OpenAI. Se você já usa a OpenAI, troque a URL base e a chave e mantenha o resto do código.
1. Pegue uma chave de API
Entre na sua conta e crie uma chave na página de chaves de API. Uma conta nova tem 5 imagens grátis, e elas valem também pela API: GPT Image 2, 2.5 ou 2.6 em 1K, uma imagem por requisição. Para qualquer outro uso, recarregue antes. A chave começa com sk-cheap- e aparece uma única vez, então copie e guarde na hora em que criar.
2. Envie uma requisição
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a red fox in the snow",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="a red fox in the snow",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: 'a red fox in the snow',
size: '1536x1024',
});3. Leia a imagem
A resposta traz uma entrada por imagem. Por padrão, cada entrada leva a imagem em base64 no campo b64_json:
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}Envie "response_format": "url" para receber um link no lugar. As imagens com link ficam guardadas por 72 horas.
Síncrona ou assíncrona
A requisição acima é síncrona: ela responde quando a imagem fica pronta. Se a requisição demora muito, ou se você envia várias de uma vez, use o modo assíncrono: adicione "async": true para receber um id de tarefa na hora e depois consultar a tarefa, ou adicione webhook_url e nós avisamos você quando terminar. Os dois modos custam o mesmo. Consulta, leitura de várias tarefas numa só chamada e webhooks estão em Requisições síncronas e assíncronas.
Quanto custa
GPT Image 2, 2.5 e 2.6 custam 8 créditos por imagem; Nano Banana 2 e 2.1 custam 12; Nano Banana Pro, gpt-image-2-adobe e as versões flare, 20; as versões sunburst, 25; os canais estáveis do Nano Banana (-1k, -2k, -4k), de 60 a 180. Tamanho e qualidade não mudam o preço (um crédito vale de US$ 0,001 a cerca de US$ 0,0018, veja /pt/pricing). Uma requisição que falha não custa nada: os créditos são reservados quando a requisição começa e devolvidos por toda imagem que não for entregue. A única exceção: os canais estáveis do Nano Banana (-1k, -2k, -4k) cobram pelas imagens recusadas por causa do conteúdo.