Resumen de imágenes

Uso	Endpoint
Base URL	`https://api.hop-base.com/v1`
Generar imágenes	`POST /v1/images/generations`
Editar imágenes	`POST /v1/images/edits`
Consultar tareas asíncronas	`GET /v1/images/tasks?task_id=…`

Para llamar a GPT Image necesita una clave del grupo GPT Image (todos los modelos); para las demás familias, vea "Elija una familia".

Genere su primera imagen en 3 líneas

En la página Claves API de la consola, cree una clave en el grupo GPT Image (todos los modelos). Una clave sin este grupo (por ejemplo, una que solo tenga Codex Plus o Codex Pro) devuelve 404 al llamar a gpt-image-*; también puede añadir el grupo a una clave existente.

Sustituya sk-su-clave por la nueva clave y ejecute. El ejemplo de curl requiere tener jq instalado.

curl https://api.hop-base.com/v1/images/generations \
  -H "Authorization: Bearer sk-su-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Un Shiba Inu bajo cerezos en flor, acuarela japonesa",
    "size": "1024x1024"
  }' \
  | jq -r '.data[0].b64_json' | base64 --decode > result.png

La imagen llega en Base64 en data[].b64_json; decodificada, es un PNG. Una imagen suele tardar entre 15 y 40 segundos; configure el tiempo de lectura del cliente en al menos 300 segundos (el motivo está en GPT Image).

Elija una familia

Cada familia pertenece a un grupo de plan distinto, así que una clave que funciona para una no necesariamente funciona para otra. Los parámetros, las respuestas y los errores están en la página de cada familia.

Familia	Características	Modo de llamada	Límite de imágenes de referencia	Precio oficial (modelo representativo)
GPT Image	Admite edición local con `mask`; se cobra por token	Síncrono; admite asíncrono	16 (oficial)	$5 / $30/ 1M tokens
Imágenes con Gemini	Niveles de 1K a 4K, cualquier proporción como `ANCHOxALTO`	Síncrono; admite asíncrono	14 (oficial)	$0,1344desde/ imagen
Seedream	Devuelve una URL válida 24 horas	Solo síncrono	14	$0,045desde/ imagen
Imágenes con Grok Imagine	No usa `size`; devuelve una URL temporal	Solo síncrono	2	$0,02/ imagen
Imágenes con Kling	Varios modelos, con ampliación de imagen y varias referencias	Asíncrono	0–10, según el modelo	$0,0294/ imagen
Midjourney	Siempre 4 imágenes por solicitud	Asíncrono	1	$0,0067desde/ imagen

Antes de una solicitud de pago, llame a GET /v1/models con la clave que va a usar y tome el ID de modelo completo de la respuesta. Los grupos de cada familia están en la tabla de referencia rápida al inicio de su página.

Reglas comunes

Autenticación y cuerpo de la solicitud

Todos los endpoints usan Authorization: Bearer sk-su-clave y la Base URL es https://api.hop-base.com/v1. El cuerpo completo de la solicitud tiene un límite de 60 MB; si lo supera, devuelve 413.

Las imágenes con Gemini también usan la estructura de OpenAI Images. No envíe un payload nativo de Gemini generateContent; HopBase adapta la solicitud según el modelo seleccionado.

Síncrono y asíncrono

Modo	Familias	Obtener el resultado
Síncrono (predeterminado)	GPT Image, Gemini, Seedream, Grok	`data[]` en el cuerpo de la respuesta
Asíncrono (añada `Prefer: respond-async`)	GPT Image, Gemini	`GET /v1/images/tasks?task_id=…`
Siempre asíncrono	Kling, Midjourney	`GET /v1/video/tasks/{task_id}`

Para imágenes 2K / 4K use el modo asíncrono y así evitará que los tiempos de espera de la CDN corten solicitudes largas. Seedream ignora Prefer y responde de forma síncrona.

Imágenes de referencia

Familia	Campo y formato
GPT Image	`image` en `/v1/images/edits`, o `image[]` multipart
Gemini	`image` / `images` en generations; Gemini (todos los modelos, incl. imagen) también puede usar edits
Seedream	`image` en generations; los archivos locales van por edits multipart
Grok Imagine	`image` o `image[]` en `/v1/images/edits`
Kling / Midjourney	`images: [{"url": …}]` o `[{"file_id": …}]`

Las URL deben ser accesibles para el servidor: no una página que requiera iniciar sesión en el navegador ni una dirección de red interna. Una Data URL debe llevar la codificación completa con el tipo MIME que corresponda a la imagen, por ejemplo data:image/png;base64,iVBORw0KGgo….

asset:// es solo para la biblioteca de recursos de Seedance 2.0 y no sirve para ninguna familia de imágenes.

Facturación

Cargo real = precio oficial × multiplicador del grupo; la referencia es la página Registros de consumo de la consola. Los 400 por parámetros no válidos se devuelven antes de generar y no se cobran; la unidad de cobro de cada familia está en su página.

Los precios unitarios están en las fichas de cada modelo y en el catálogo de modelos tras iniciar sesión.

Próximos pasos

Parámetros y respuestas por familia: GPT Image, Imágenes con Gemini, Seedream, Imágenes con Grok Imagine, Imágenes con Kling, Midjourney
Las tablas completas de parámetros están en la referencia de la API: Generar imágenes y Editar imágenes
Para generar video, consulte la API de video
Si algo falla, revise Solución de problemas

En esta página