API de generación de imágenes compatible con OpenAI: guía de GPT Image 2
Genera imágenes a partir de texto con GPT Image 2 y la API de BetterToken compatible con OpenAI: API Key, Base URL, parámetros, Python, JavaScript y gestión de errores.
POST /v1/images/generations
El endpoint de texto a imagen usa un cuerpo de solicitud application/json. Envía un prompt, mantén abierta la solicitud HTTP y lee la imagen generada desde data[0].b64_json en la misma respuesta.
https://www.bettertoken.ai/v1 como Base URL. Envía tu BetterToken API Key mediante Authorization: Bearer YOUR_API_KEY.Inicio rápido con curl
Usahttps://www.bettertoken.ai/v1 como Base URL y envía una solicitud a https://www.bettertoken.ai/v1/images/generations:
Valores recomendados
Envía estos campos de forma explícita en cada solicitud:n > 1.
Tamaños recomendados
size representa la proporción y el nivel de tamaño esperados. El servidor puede asignar o ajustar los píxeles devueltos. Usa las dimensiones de la imagen decodificada en lugar de recortar la salida por la fuerza al valor solicitado.
Guarda la imagen
Una respuesta correcta sigue la estructura de imagen compatible con OpenAI:data[0].b64_json y guárdalo como contenido de imagen en base64. La respuesta puede incluir campos adicionales como revised_prompt; permite esos campos en tu cliente.
Define siempre output_format: "png". Después, guarda la imagen decodificada como .png sin inspeccionar las cabeceras del archivo.
Ejemplo con JavaScript (Node.js)
Flujo de respuesta
Este endpoint es síncrono. Después de enviarPOST /images/generations, mantén abierta la solicitud HTTP hasta que responda el servidor. Cuando la generación se completa, el contenido de la imagen se devuelve en data[0].b64_json.
El endpoint no devuelve un task_id, y no existe un endpoint separado para consultar el estado o descargar el resultado.
Tiempos de espera y reintentos
- Configura tiempos de espera de varios minutos en el cliente HTTP.
- Reintenta los errores de transporte,
408,409,425,429y5xx. - No reintentes automáticamente
400,401, parámetros ausentes ni solicitudes mal formadas. - Usa espera exponencial, por ejemplo,
3s,8sy15s. - Si no puedes aceptar imágenes duplicadas, registra tu propio ID de solicitud antes de reintentar.
Gestión de errores
Los errores suelen devolver JSON. Al mostrar un error, lee primeroerror.message, después message y, por último, el texto del estado HTTP.
Lista de integración
- La Base URL es
https://www.bettertoken.ai/v1. - La cabecera contiene
Authorization: Bearer YOUR_API_KEY. - La solicitud usa
application/jsonyPOST /images/generations. modelesgpt-image-2,response_formatesb64_json,output_formatespngynes1.sizees uno de los valores recomendados, como1024x1024.- Tu cliente HTTP permite varios minutos para la generación.
Documentación relacionada
Autorizaciones
Use your BetterToken API Key as a bearer token. Do not expose API keys in frontend browser code, screenshots, logs, tickets, or Git repositories.
Cuerpo
固定使用 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"

