GPT-IMAGEGPT Image 2
GPT Image 2 · Generar
Imagen / GPT / GPT Image 2 / Generar
POST
/v1/images/generationsParámetros de solicitud
Authorization
Añade un header Authorization cuyo valor sea Bearer seguido de tu API key.
Authorization: Bearer ****************
Parámetros de header
Content-TypestringOpcional
application/json
AcceptstringOpcional
application/json
Parámetros de bodyapplication/jsonobligatorio
modelstringObligatorio
ID del modelo, fijo en `gpt-image-2`
promptstringObligatorio
Descripción de la imagen
nintegerOpcional
Número de imágenes, por defecto `1`
sizestringOpcional
Resolución, p. ej. `1024x1024`
qualitystringOpcional
Nivel de calidad (cuando el modelo lo admite)
response_formatstringOpcional
Formato de retorno. `url` solo aplica a modelos que lo admiten (p. ej. DALL-E); OpenAI gpt-image siempre devuelve `b64_json` e ignora este campo.
output_formatstringOpcional
Formato de codificación de la imagen (png / jpeg / webp); aplica a modelos OpenAI gpt-image.
output_compressionintegerOpcional
Nivel de compresión 0–100; solo afecta a jpeg / webp.
backgroundstringOpcional
Tipo de fondo (transparent / opaque / auto); transparent requiere png o webp.
moderationstringOpcional
Rigor de moderación (auto / low); el upstream sigue moderando.
userstringOpcional
Identificador opcional de usuario final reenviado al upstream para detección de abuso.
Ejemplo
{ "model": "gpt-image-2", "prompt": "Un golden retriever corriendo en la nieve", "n": 1, "size": "1024x1024", "response_format": "b64_json"}Código de ejemplo
curl https://api.hotrouter.ai/v1/images/generations \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "Un golden retriever corriendo en la nieve", "n": 1, "size": "1024x1024", "response_format": "b64_json" }'Respuesta
200 · Éxito
createdintegerOpcional
Marca de tiempo de creación (segundos)
dataarray[object]Obligatorio
Imágenes generadas
Ejemplo
{ "created": 1730000000, "data": [ { "b64_json": "<base64>" } ]}