API de geração de imagens compatível com OpenAI: guia do GPT Image 2
Gere imagens a partir de texto com GPT Image 2 e a API compatível com OpenAI da BetterToken: API Key, Base URL, parâmetros, Python, JavaScript e erros.
POST /v1/images/generations
O endpoint de texto para imagem usa um corpo de solicitação application/json. Envie um prompt, mantenha a solicitação HTTP aberta e leia a imagem gerada em data[0].b64_json na mesma resposta.
https://www.bettertoken.ai/v1 como Base URL. Passe sua BetterToken API Key por Authorization: Bearer YOUR_API_KEY.Início rápido com curl
Usehttps://www.bettertoken.ai/v1 como Base URL e envie uma solicitação para https://www.bettertoken.ai/v1/images/generations:
Valores recomendados
Envie estes campos explicitamente em cada solicitação:n > 1.
Tamanhos recomendados
size representa a proporção e a faixa de tamanho esperadas. Os pixels retornados podem ser mapeados ou ajustados pelo servidor. Use as dimensões da imagem decodificada em vez de recortar à força a saída para o valor solicitado.
Salve a imagem
Uma resposta bem-sucedida segue o formato de resposta de imagem compatível com OpenAI:data[0].b64_json e salve-o como conteúdo de imagem base64. A resposta pode incluir campos extras, como revised_prompt; permita esses campos no cliente.
Defina sempre output_format: "png". Depois salve a imagem decodificada como .png, sem inspecionar cabeçalhos de arquivo.
Exemplo JavaScript (Node.js)
Fluxo de resposta
Este endpoint é síncrono. Depois de enviarPOST /images/generations, mantenha a solicitação HTTP atual aberta até o servidor responder. Quando a geração é bem-sucedida, o conteúdo da imagem é retornado em data[0].b64_json.
O endpoint não retorna task_id, e não há endpoint separado para consulta de status ou download do resultado.
Timeouts e novas tentativas
- Defina timeouts do cliente HTTP para vários minutos.
- Tente novamente erros de transporte,
408,409,425,429e5xx. - Não tente novamente automaticamente
400,401, parâmetros ausentes ou solicitações malformadas. - Use backoff exponencial, como
3s,8se15s. - Se imagens duplicadas forem inaceitáveis, registre seu próprio ID de solicitação antes de tentar novamente.
Tratamento de erros
Os erros geralmente retornam JSON. Ao mostrar um erro, leia primeiroerror.message, depois message e, por fim, o texto de status HTTP.
Checklist de integração
- A Base URL é
https://www.bettertoken.ai/v1. - O cabeçalho contém
Authorization: Bearer YOUR_API_KEY. - A solicitação usa
application/jsonePOST /images/generations. modelégpt-image-2,response_formatéb64_json,output_formatépngené1.sizeé um dos valores recomendados, como1024x1024.- Seu cliente HTTP permite vários minutos para a geração.
Documentação relacionada
Autorizações
Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.
Corpo
固定使用 YOUR_MODEL_ID。
YOUR_MODEL_ID "YOUR_MODEL_ID"
图片生成提示词。
"一张未来感 AI 产品海报,浅色背景,玻璃质感,干净构图,高级科技感"
推荐固定为 1。多张图片建议发起多次独立请求。
1 <= x <= 11
图片尺寸和比例档位。auto 为自动;1024x1024 和 2048x2048 为 1:1;1536x1024 为 3:2;1024x1536 为 2:3;1536x1152 为 4:3;1152x1536 为 3:4;2048x1152 和 3840x2160 为 16:9;2160x3840 为 9:16。实际返回像素可能由服务端映射或调整,客户端应以解码后的真实图片尺寸为准。
auto, 1024x1024, 1536x1024, 1024x1536, 1536x1152, 1152x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 "1024x1024"
推荐固定为 b64_json,便于稳定保存图片。
b64_json "b64_json"
推荐固定为 png。不要依赖 jpeg 或 webp 直接返回对应格式。
png "png"

