Constructor de solicitudes de imagen | Documentación de HopBase

Elija un modelo, complete los parámetros y obtenga al instante una solicitud ejecutable con su código. Solo se muestran los parámetros que admite el modelo; los límites, los valores enumerados y los mensajes de error provienen del código de validación de la pasarela.

modelObligatorio

GPT Image (todos los modelos)

promptObligatorioNo puede estar vacío (sin contar espacios iniciales y finales) · Límite oficial: 32.000 caracteres

sizeOpcionalLados múltiplos de 16, cada lado ≤ 3840

Píxeles totales 655.360–8.294.400, relación entre lado mayor y menor ≤ 3:1. Si no se cumple, devuelve 400 antes de generar y no se factura.

qualityOpcionalPredeterminado auto; se reenvía tal cual

Cuanto más alto el nivel, más tokens de salida y mayor costo

nOpcional1–10 (rango oficial)

Algunos grupos solo admiten 1 imagen; confírmelo antes de generar en lote

backgroundOpcionalPredeterminado auto

output_formatOpcionalPredeterminado png

moderationOpcionalPredeterminado auto; low no desactiva los controles de seguridad

imageOpcional1–16 imágenes (límite oficial)

0 / 16

Con imágenes de referencia se usa POST /v1/images/edits; cada URL remota ≤ 25 MiB y debe devolver image/*

Sin efecto

response_format
Siempre devuelve b64_json; omítalo
partial_images
No admite eventos de imagen progresiva; omítalo

POST /v1/images/generations

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Foto principal de producto con fondo blanco: un termo de acero inoxidable, luz de estudio suave, sujeto centrado",
    "size": "1024x1024"
  }'

$0,006–0,0528

Nivel auto sin medir; rango low–high × 1 imagen(es) (salida $30/1M tokens)

Estimación a precio oficial; cargo real = precio oficial × multiplicador del grupo

Ver el Schema de este modeloJSON Schema Índice de todos los modelos OpenAPI 3.1

…

Contratos legibles por máquina

Las especificaciones que usa el constructor también se publican como JSON Schema (draft 2020-12) y OpenAPI 3.1. Un asistente de programación puede generar y autovalidar solicitudes con el Schema: incluye campos obligatorios, tipos, límites, valores enumerados, reglas condicionales (por ejemplo, el máximo de imágenes por nivel de Gemini) y los campos que devuelven 400; x-hopbase añade los grupos disponibles, el precio oficial y la procedencia de los datos.

/spec/models/index.json: Índice de contratos de todos los modelos de imagen
/openapi.json: POST /v1/images/generations y POST /v1/images/edits; el cuerpo de la solicitud hace referencia al Schema de cada modelo

Fuentes: las especificaciones de parámetros provienen de spec/openai.json, spec/gemini.json y spec/seedance.json (exportados por los plugins de la pasarela desde su código de validación) y de spec/official.json; los precios, de una instantánea de la API pública de precios. Los costos se estiman a precio oficial; cargo real = precio oficial × multiplicador del grupo.