Resumen de video

La generación de video es una tarea asíncrona: envíe la solicitud, obtenga un ID de tarea, consulte hasta que termine y descargue el resultado dentro de su plazo de validez.

# 1. Envíe la tarea y guarde el task.id devuelto (con la forma vt…)
curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-tu-clave" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      {
        "type": "text",
        "text": "Un gato naranja corre por el pasto soleado; la cámara lo sigue"
      }
    ]
  }'

# 2. Consulte cada 5 segundos hasta que task.status sea completed
#    La URL del video está en task.outputs
curl https://api.hop-base.com/v1/video/tasks/vt-tu-task-id \
  -H "Authorization: Bearer sk-tu-clave"

Elegir una familia

HopBase ofrece siete familias de modelos de video. Salvo Gemini Omni, que responde de forma síncrona, todas siguen el mismo flujo asíncrono descrito abajo: enviar → consultar → descargar.

La columna de precio muestra el tramo más bajo de cada familia; los tramos completos están en la página de cada familia y en las fichas de modelo. Los modos especiales de Kling, como la sincronización labial, tienen precio propio. Su tarifa es la que aparece en la Plaza de modelos con la sesión iniciada.

ID de modelo y grupos

Cada familia pertenece a su propio grupo; llámela con una clave que incluya ese grupo.

Kling también incluye modelos de control de movimiento, avatar y sincronización labial; vea su página. La solicitud mínima y la ubicación del resultado de cada familia:

En MiniMax, solo texto requiere también ratio. Los modos especiales de Kling están en su página. En Seedance, content[] suele llevar elementos text e image_url.

Flujo de la tarea: enviar → consultar → descargar

Todos los modelos de video, salvo Gemini Omni, siguen estos tres pasos.

Enviar

HopBase entrega cada solicitud a la familia correspondiente según su model y los grupos de la clave. El cuerpo de la solicitud y los valores de estado cambian según la familia, así que siga la página de cada una. Cada familia devuelve un código de éxito distinto al enviar; trate cualquier 2xx como envío correcto.

Una clave solo llega a las familias cuyos grupos incluye; una misma clave puede incluir varios grupos de video. Gemini Omni comparte grupo con el chat y las imágenes de Gemini. Llame a GET /v1/models con la clave que vaya a usar y tome de la respuesta el ID de modelo completo. Los ID son exactos: un nombre desconocido se rechaza y nunca se enruta a la coincidencia más cercana.

Consultar

Consulte el estado con el ID de tarea devuelto al enviar hasta que la tarea termine bien o falle. Seedance, Grok Imagine, MiniMax y Kling también tienen lista de tareas:

GET /v1/video/tasks?page=1&limit=20

Wan 3.0 y HappyHorse no tienen endpoint de lista; conserve los ID de tarea por su cuenta.

Descargar

Las URL de salida son URL firmadas en api.hop-base.com, válidas desde que termina la tarea:

Volver a consultar devuelve la misma URL sin prolongarla, y una URL caducada devuelve 410. Descargue y guarde los resultados cuanto antes.

Saldo y facturación

Al enviar un video se comprueba el saldo disponible menos las estimaciones de las tareas en curso menos la estimación de esta solicitud. Si no alcanza, recibe un 402 con code insufficient_balance. La estimación se libera automáticamente cuando termina la tarea.

Insufficient balance: available $X, reserved in flight $Y, this request estimated $Z
Insufficient quota: …    # miembro de empresa con cupo de gasto insuficiente: el message empieza así

La sincronización labial de Kling no puede estimarse y no reserva nada; Gemini Omni tampoco reserva.

Las tareas de video fallidas nunca se facturan. Cuando la tarea termina, la consulta de esa tarea también devuelve usage en la raíz:

Una tarea fallida sin cargo muestra 0. El campo no aparece mientras la tarea está en curso y, al consultar una sola tarea, solo se devuelve a la clave que la creó; los importes de los ejemplos son ilustrativos. En la lista de tareas (GET /v1/video/tasks sin ID de tarea), cada tarea finalizada lleva los mismos cost, cost_usd y currency en su usage; la lista abarca toda la cuenta, así que las tareas creadas con otras claves de la misma cuenta también llevan el importe.

Los precios de lista oficiales están en la página de precios. Su tarifa es la que aparece en la Plaza de modelos con la sesión iniciada, y el cargo real de cada solicitud está en la página Consumo de la consola.

Fallos, tiempo límite y cancelación

Un 2xx al enviar solo significa que la tarea fue aceptada. Si la generación falla, la consulta sigue devolviendo HTTP 200 con estado fallido y un motivo en inglés, sin código de error estable.

En Seedance lea task.error.message; para otras familias, vea su página. La página de Uso de la consola muestra la categoría del fallo y una sugerencia; vea Errores.

El límite de tiempo de las tareas en curso varía según la familia; vea la página de cada una. Una tarea de Seedance que sigue sin terminar 24 horas después de crearse pasa automáticamente a fallida con este message:

The task did not finish within 24 hours and was terminated automatically

Las tareas de video no se pueden cancelar.

Comparación de medios de referencia

Cuántos medios de referencia acepta cada modelo:

• En Seedance, primer/último fotograma admite como máximo 2 imágenes; en 2.0 los fotogramas no se mezclan con referencias.
• En MiniMax-H3, fotogramas y referencias son excluyentes; H3-Max no acepta ningún reference_*.
• En Wan 3.0, documento y web son ≤1 cada uno y excluyentes; los fotogramas excluyen el grupo de referencia.
• En Kling, usage y modos especiales dependen del modelo; vea su página.
• En Grok Imagine, content solo lleva texto.

Qué codificación acepta cada modelo:

El registro en la biblioteca de Seedance 2.0 solo acepta URL HTTP(S). En MiniMax-H3-Max, una Data URL no evita las restricciones de tipo de referencia. HappyHorse no admite video ni audio de referencia.

Una Data URL es data:MIME;base64,contenido, no base64 puro. Solo el campo data nativo de Gemini Omni usa base64 puro; no es una cadena Data URL como en los demás modelos.

Próximos pasos

• Seedance: parámetros, respuestas y errores de Seedance 2.0 / 2.5
• Kling: parámetros y modos de tarea de video de Kling
• Referencia de la API: enviar tarea de video: campos completos de cada familia
• Concurrencia, tiempos de espera y facturación: límites de concurrencia, tiempos de espera y reglas de facturación
• Códigos de error y reintentos: qué significa cada código de error y si conviene reintentar