API unificada de video: Seedance, Kling y Hailuo

Sí. HopBase reúne varias familias de modelos de video en una sola API de tareas asíncronas: Seedance (2.0 y 2.5), Kling (incluido 4.0), MiniMax Hailuo (H3 y H3-Max) y el video de Grok Imagine se envían con POST /v1/video/generate y se consultan con GET /v1/video/tasks/{task_id}. Wan 3.0 y HappyHorse 1.1 de Alibaba mantienen sus rutas oficiales (POST /api/v1/services/aigc/video-generation/video-synthesis, con consulta en GET /api/v1/tasks/{task_id}). Una clave puede incluir hasta 10 grupos, así que una sola clave y un solo saldo en USD cubren todas las familias. Lo común es el ciclo de enviar, consultar y descargar, la cuenta y el saldo; cada cuerpo de solicitud sigue usando los campos de su familia. Las tareas de video fallidas no se cobran y los enlaces de resultado valen 24 horas desde que la tarea termina.

Qué está unificado y qué no

Empiece por la solicitud mínima de cada familia y por dónde aparece el resultado. Estas son las diferencias que su código de consulta debe absorber:

Familia	Enviar / consultar	Solicitud mínima	Respuesta al enviar	Leer al terminar
Seedance	`/v1/video/generate` / `/v1/video/tasks/{task_id}`	`model` + `content[]` no vacío	200, `task.id` (`vt…`)	`task.outputs`
Video de Grok Imagine	Igual	`model` + `prompt` o `content` + `resolution`	200, `task.id` (`vt…`)	`task.outputs`
MiniMax Hailuo	Igual	`model` + `content` + `resolution` + `duration` (solo texto requiere además `ratio`)	202, `id` (`mmt…`)	`outputs`
Kling	Igual	`model` + `prompt` o `images[]` / `videos[]`	202, `id` (`kt…`)	`outputs`
Wan 3.0 / HappyHorse 1.1	`/api/v1/services/aigc/video-generation/video-synthesis` / `/api/v1/tasks/{task_id}`	`model` + `input` (`parameters` opcional)	200, `output.task_id`	`output.video_url`

Los códigos de éxito varían (200 o 202), así que trate cualquier 2xx como envío aceptado. Seedance y Grok envuelven la respuesta en task; Kling y Hailuo usan campos de primer nivel. Los estados intermedios también cambian (pending / processing en Seedance, queued / processing en Kling y Hailuo), pero los estados finales son siempre completed o failed. Wan y HappyHorse informan output.task_status, que termina en SUCCEEDED o FAILED.

Comparación de las familias de modelos de video

Todos los valores proceden de la documentación de HopBase. Para las variantes, use los ID completos que devuelve GET /v1/models con su clave:

Familia e ID de modelo	Resoluciones	Duración (s)	Referencias	Audio
Seedance 2.0: `dreamina-seedance-2-0-260128` (Standard), `-fast-260128`, `-mini-260615`; ID de China `doubao-seedance-2-0-*-a`	Standard 480p / 720p / 1080p, más 4K en Standard internacional; Fast y Mini 480p / 720p	4–15 o `-1`	`content`: imágenes ≤9, videos ≤3, audios ≤3	`generate_audio` (en 2.0, envíelo explícitamente)
Seedance 2.5: `dreamina-seedance-2-5-260628`; ID de China `doubao-seedance-2-5-260628-a`	480p / 720p / 1080p (1080p internacional según el grupo; sin 4K)	4–30 o `-1`	`content`: imágenes ≤30, videos ≤10, audios ≤10	`generate_audio`, por defecto `true`
Kling 4.0: `kling-v4`	720p / 1080p	3–30	Solo texto a video y primer fotograma a video	Siempre con sonido; `audio` no cambia el precio
Kling 3: `kling-v3`, `kling-v3-omni`, `kling-v3-turbo`	720p / 1080p / 2k / 4k	3–15	`images[]` / `videos[]`, sujetos; guiones `shots` en v3 y v3-omni	Con o sin audio en v3 y v3-omni
Hailuo H3: `MiniMax-H3`	768P / 2K	4–15	`content`: imágenes ≤9, videos ≤3, audios ≤3, ≤12 en total	Integrado
Hailuo H3-Max: `MiniMax-H3-Max`	480P / 768P	5–15	Solo texto o primer/último fotograma; sin `reference_*`	Integrado
Grok Imagine: `grok-imagine-video-1.5`	480p / 720p / 1080p (480p / 720p con imágenes de referencia)	1–15	`reference_images` de primer nivel ≤14, solo URL públicas	Sin parámetro de audio (`generate_audio` se rechaza)
Wan 3.0: `wan3.0-video`	480P / 720P / 1080P	2–30	`input.media[]`: imágenes ≤10, videos ≤5, audios ≤5, ≤1 documento o página web	Interruptor `audio`, mismo precio
HappyHorse 1.1: `happyhorse-1.1-t2v` / `-i2v` / `-r2v`	480P / 720P / 1080P	3–15	t2v ninguna; i2v exactamente 1 primer fotograma; r2v 1–9 imágenes de referencia	—

Kling también ofrece control de movimiento (kling-v3-motion-control), avatar (kling-avatar) y sincronización labial (kling-lip-sync) en la misma API de tareas.

Ejemplo completo: enviar y consultar Seedance 2.5

1. Envíe la tarea. Todos los campos van en el primer nivel; no los anide dentro de parameters:

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "An orange cat runs across sunlit grass as the camera follows" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

2. Un envío correcto devuelve 200. Guarde task.id:

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "pending",
    "outputs": [],
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": null
  }
}

3. Consulte cada 5 segundos hasta que task.status sea completed o failed. Las consultas no se cobran ni consumen concurrencia:

curl https://api.hop-base.com/v1/video/tasks/vt-your-task-id \
  -H "Authorization: Bearer sk-your-key"

4. Al terminar, lea la URL del clip en task.outputs (un arreglo de cadenas). El campo de primer nivel usage.cost_usd es el importe en USD descontado por la tarea. Los enlaces valen 24 horas desde que termina la tarea y después devuelven 410, así que descargue el resultado a tiempo. Los clips de 480p y 720p suelen tardar de 2 a 5 minutos.

Para cambiar de familia, conserve el código de consulta y cambie solo el cuerpo. Kling usa prompt + aspect_ratio; Hailuo usa el formato v2 de MiniMax con content + resolution + duration. Una trampa: Seedance ignora sin error size, seconds, n y aspect_ratio, y genera con la duración por defecto y 720p; envíe siempre duration, resolution y ratio.

Comparado con usar la consola de cada proveedor

Criterio	Cada proveedor por separado	API de tareas unificada (HopBase)
Cuentas	Registro, verificación y recarga en cada plataforma	Una cuenta, una clave (hasta 10 grupos)
Formato de solicitud	Distinto en cada proveedor	Sigue siendo por familia, pero con una sola ruta para enviar y consultar (salvo Wan / HappyHorse)
Unidad de cobro	Distinta; usted normaliza	También distinta: Seedance por millón de tokens de video; Kling, Hailuo, Wan y Grok por segundo; todo desde un saldo en USD
Costo por tarea	En la factura de cada proveedor	Devuelto como `usage.cost_usd` al terminar la tarea
Enlaces de resultado	Vigencias distintas	24 horas en todas las familias

Precios y reglas de cobro

Precio = tarifa oficial del proveedor × la tarifa de su grupo; consulte la página de precios. Ejemplos de tarifa oficial: MiniMax-H3-Max 480p $0.05 por segundo, kling-v4 720p $0.1471 por segundo, wan3.0-video 480p $0.04412 por segundo.
Las tareas de video fallidas no se cobran, y los 400 en el envío tampoco.
Al enviar se comprueba saldo disponible menos estimaciones en curso menos la estimación de esta tarea; si no alcanza, recibe 402 insufficient_balance.
Las tareas no se pueden cancelar. No reenvíe tras un envío correcto: cada reenvío es otra tarea cobrada.

Más detalle: Cómo acceder a los modelos de video con IA chinos desde fuera de China recorre la configuración de cada familia; Precios de la API de Seedance (2026) convierte tokens en costo por segundo; la guía de la API de Kling 4.0 cubre kling-v4; y todos los campos están en la documentación de video. Para probarlo, regístrese y cree una clave con los grupos de video que necesite.

Preguntas frecuentes

¿Existe una API que admita Seedance, Kling y Hailuo a la vez?

Sí. En HopBase, esas tres y el video de Grok Imagine comparten POST /v1/video/generate y GET /v1/video/tasks/{task_id}; basta con añadir los grupos correspondientes a una clave. Los cuerpos siguen los campos de cada familia y un mismo bucle de consulta sirve para todas.

¿Me cobran si falla la generación de un video?

No. Las tareas de video fallidas no se cobran y la consulta muestra usage.cost_usd en 0. Las solicitudes rechazadas al enviar, como un 400 por un parámetro incorrecto, tampoco se cobran.

¿Qué ID de Seedance deben usar los desarrolladores fuera de China?

Seedance es la única familia con dos juegos de ID: internacional dreamina-seedance-* y China doubao-seedance-*-a, cada uno con una clave que incluya su grupo. El 4K solo existe en 2.0 Standard internacional. Kling, Hailuo, Wan y Grok tienen un único juego de ID. Llame a GET /v1/models para ver exactamente qué puede usar su clave.