Introduction

Texto

Imagen

GenerarPOSTEditarPOST
StarmodelStarmodel
EmpezarReferencia API
gpt-imagegpt-image-2

gpt-image-2 · Generar

Imagen / GPT / gpt-image-2 / Generar

POST/v1/images/generations

Pará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.starmodel.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>"    }  ]}

On this page

Parámetros de solicitudCódigo de ejemploRespuesta
{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}
{
  "model": "gpt-image-2",
  "prompt": "Un golden retriever corriendo en la nieve",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}
curl https://api.starmodel.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"
  }'