Expansión del prompt para imagen y vídeo

26 de octubre de 2026 · Hyperouter · 3 min de lectura

Los modelos de imagen y vídeo responden bien a prompts largos y específicos, y la mayoría de la gente escribe prompts cortos. La expansión del prompt cierra esa brecha: con "prompt_expand": true, Hyperouter reescribe tu prompt para el modelo antes de generar. Una imagen recibe una descripción más completa, y un vídeo, un guion segundo a segundo.

Está desactivada por defecto, así que el prompt llega al modelo tal como lo escribiste.

Qué modelos la aceptan

La aceptan los modelos de imagen y vídeo de Lumina y Qwen que listan prompt_expand. Se añaden modelos con el tiempo, así que consulta la lista en lugar de fiarte de una publicación: GET /v1/models devuelve supported_parameters de cada modelo, y un modelo que acepta el campo lista prompt_expand ahí.

curl https://api.hyperouter.app/v1/models \
  -H "Authorization: Bearer $HYPEROUTER_API_KEY"

El campo solo funciona para crear una imagen o un vídeo. En cualquier otro modelo, y en la edición, extensión o remezcla de un vídeo, se rechaza con 400 unsupported_parameter. No se puede combinar con prompt_extend: true, que se rechaza con 400 invalid_body.

Actívala en una solicitud

prompt_expand es un campo de primer nivel de las llamadas de creación de imagen y de vídeo. Los SDK de OpenAI lo envían como un campo adicional del cuerpo. Qwen Image 2.0 lo acepta:

curl https://api.hyperouter.app/v1/images/generations \
  -H "Authorization: Bearer $HYPEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen-image-2.0",
    "prompt": "A lighthouse at dusk",
    "prompt_expand": true
  }'

img = client.images.generate(
    model="qwen/qwen-image-2.0",
    prompt="A lighthouse at dusk",
    extra_body={"prompt_expand": True},
)
print(img.data[0].url)

Para un vídeo, usa POST /v1/videos con el mismo campo. Un segundo campo, locale, es una etiqueta BCP 47 como zh-CN. Junto con prompt_expand, fija el idioma de los diálogos de un vídeo, cuando el modelo habla ese idioma. Sin él, los diálogos están en inglés.

Mira lo que se generó

La respuesta incluye expanded_prompt, el prompt que recibió el modelo. Tu propio prompt no cambia. El campo aparece en:

• la respuesta de imagen;
• el objeto Video;
• GET /v1/generations/{id}.

Hyperouter conserva expanded_prompt durante 30 días tras la solicitud y después responde null. También es null cuando no se expandió nada.

Guarda expanded_prompt en tus propios registros si lo quieres durante más de 30 días.

Cuánto cuesta

La reescritura se cobra en la misma solicitud, a los precios por token de x-ai/grok-4.6 según los tokens que usó. Hyperouter retiene por adelantado lo máximo que puede costar la reescritura, junto con la generación, como hace con cualquier solicitud, y cobra lo que se usó. No hay una segunda llamada.

Una reescritura que falla, agota el tiempo o no se puede usar no hace fallar tu solicitud. El modelo genera con tu prompt tal como lo enviaste, la respuesta trae expanded_prompt: null y la reescritura no cuesta nada.

Cómo obtener acceso

La expansión del prompt está disponible para una cuenta cuando Hyperouter la habilita. Para solicitar el acceso, abre un ticket de soporte en el panel.

Hasta que se habilite, GET /v1/models no lista prompt_expand en ningún modelo. Una solicitud con prompt_expand: true en un modelo que lo ofrece responde:

{
  "error": {
    "message": "...",
    "type": "permission_error",
    "code": "feature_not_enabled",
    "param": "prompt_expand"
  }
}

El estado es 403. No se retiene nada y no se envía nada al proveedor, así que la solicitud rechazada no cuesta nada. Compara por code, no por message.

Qué sigue

• La sección Expansión del prompt de la referencia expone las reglas completas.
• Imágenes y Vídeos enumeran todos los campos de las llamadas de creación.
• Cada solicitud tiene un ID que puedes citar muestra cómo consultar una solicitud más tarde.