Enviar una tarea de video

Endpoint unificado de envío de video asíncrono: lo comparten Seedance, MiniMax Hailuo, Kling y Grok Imagine, y se asigna según el model y el grupo de la clave.

POST/v1/video/generate

Seedance, MiniMax, Kling y Grok video comparten este único endpoint de envío; HopBase dirige la solicitud a la familia correspondiente según el model y el grupo de la clave. El cuerpo de la solicitud y los valores de estado varían por familia: elija una familia abajo para ver sus parámetros. Después de enviar, consulte con Consultar una tarea de video.

Al enviar se comprueba «saldo disponible − costo estimado de las tareas en curso − costo estimado de esta tarea»; si no alcanza, devuelve 402 insufficient_balance. Las tareas fallidas nunca se facturan; las tareas no se pueden cancelar; una tarea de Seedance que no termina en 24 horas se marca automáticamente como fallida (The task did not finish within 24 hours and was terminated automatically). No vuelva a enviar después de un envío correcto: cada reenvío es otra tarea facturada.

Wan 3.0 / HappyHorse usan la ruta nativa de video POST /api/v1/services/aigc/video-generation/video-synthesis (sin /v1 delante); ver Wan y HappyHorse. Gemini Omni responde de forma síncrona; ver Video de Gemini Omni.

Enviar una tarea de video

curl https://api.hop-base.com/v1/video/generate \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-5-260628",
    "content": [
      {
        "type": "text",
        "text": "Un gato naranja corre por el pasto iluminado por el sol mientras la cámara lo sigue"
      }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }'

200application/json

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

Encabezados

Authorization:obligatoriostring

Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado

Parámetros del cuerpoJSON

Familia

Documentación del modelo

Tipos estrictos: enteros y booleanos enviados como cadenas se rechazan. frames, seed, camera_fixed, draft, draft_task y service_tier devuelven 400; size, seconds, n y aspect_ratio no son parámetros de Seedance: no dan error, pero se ignoran. El cuerpo de la solicitud admite hasta 64 MB.

model:obligatoriostring

ID de modelo de Seedance; el grupo de China también acepta los ID internacionales dreamina-* como alias de compatibilidad (4K se sigue rechazando)

Valoresdoubao-seedance-2-0-260128-adoubao-seedance-2-0-fast-260128-adoubao-seedance-2-0-mini-260615-adoubao-seedance-2-5-260628-adreamina-seedance-2-0-260128dreamina-seedance-2-0-epdreamina-seedance-2-0-fast-260128dreamina-seedance-2-0-fast-epdreamina-seedance-2-0-fast-hcdreamina-seedance-2-0-hcdreamina-seedance-2-0-mini-260615dreamina-seedance-2-0-mini-epdreamina-seedance-2-0-mini-hcdreamina-seedance-2-5-260628

content:obligatorioarray of object

Prompt y medios de referencia. El prompt va en un elemento text; enviar solo un prompt de nivel superior se rechaza (missing content)

Elementos≥ 1MáximoImágenes de referencia: 2.0 ≤ 9, 2.5 ≤ 30; videos: 2.0 ≤ 3, 2.5 ≤ 10; audios: 2.0 ≤ 3 (junto con imagen o video), 2.5 ≤ 10; fotogramas inicial/final como máximo 2

duration:opcionalinteger

2.0: 4–15 o -1 (automático); 2.5: 4–30 o -1. Por defecto 5 en 2.0 y -1 en 2.5; con -1 se reserva saldo para la duración máxima

Rango-1–30

resolution:opcionalstring

Los niveles disponibles varían por modelo (2.0 Estándar internacional incluye 4K; Fast / Mini solo 480p / 720p; 2.5 no admite 4K)

Valores480p720p1080p4k

Predeterminado"720p"

ratio:opcionalstring

Relación de aspecto

Valores16:94:31:13:49:1621:9adaptive

Predeterminado"adaptive"

generate_audio:opcionalboolean

En 2.5 por defecto true; en 2.0 no se completa, envíelo explícitamente

watermark:opcionalboolean

En 2.5 por defecto false; en 2.0 no se completa, envíelo explícitamente

return_last_frame:opcionalboolean

Si se obtiene el último fotograma, devuelve task.last_frame_url; en 2.5 por defecto true, en 2.0 no está garantizado

priority:opcionalinteger

Prioridad de la tarea

Rango0–9

execution_expires_after:opcionalinteger

Segundos; no cambia el límite de 24 horas

Rango3600–259200

callback_url:opcionalstring

URL HTTP(S); no sustituye la consulta periódica

safety_identifier:opcionalstring

1–64 caracteres ASCII

Longitud1–64 caracteres

model:obligatoriostring

Un ID de video de la matriz de modelos; un ID de generación de imágenes devuelve 400

Valoreskling-avatarkling-lip-synckling-o1kling-v1-6kling-v2-0kling-v2-1kling-v2-5-turbokling-v2-6kling-v2-6-motion-controlkling-v3kling-v3-motion-controlkling-v3-omnikling-v3-turbo

prompt:opcionalstring

Obligatorio sin medios; solo puede ir vacío con images / videos; no se necesita para sincronización labial

Longitud≤ 2500 caracteres

duration:opcionalinteger

Rangos por modelo en la matriz de modelos de Kling; kling-v2-6 solo 5 / 10. No lo envíe en control de movimiento, avatar ni sincronización labial: la duración se toma de los medios

Predeterminado5

resolution:opcionalstring

No distingue mayúsculas; niveles por modelo en la página de Kling

Valores720p1080p2k4k

Predeterminado"720p"

aspect_ratio:opcionalstring

Si se omite, el gateway no lo completa

Valores16:99:161:1

audio:opcionalboolean

Si se genera audio; ver cada modelo en la página de Kling

Predeterminadofalse

images:opcionalarray of object

Fotogramas inicial/final o imágenes de referencia; obligatorio en control de movimiento / avatar; cantidad según la matriz de modelos

videos:opcionalarray of object

Video de referencia / a editar, ≤ 1 elemento; obligatorio en control de movimiento

Elementos≤ 1

subjects:opcionalarray of object

Sujetos personalizados; solo kling-v3-turbo, kling-v3 y kling-v3-omni

shots:opcionalobject

Tomas, ≤ 6 segmentos; solo kling-v3 y kling-v3-omni

extra:opcionalobject

Obligatorio en avatar / sincronización labial; en control de movimiento puede enviarse character_orientation; en modelos de video normales cualquier clave devuelve 400

Respuesta

200Envío correcto de Seedance / Grok

202Envío correcto de MiniMax / Kling

Familia

task:opcionalobject

Errores

400Falló la validación de parámetros: respuesta síncrona, sin crear tarea ni facturar; la mayoría solo trae error.message, sin code

402insufficient_balance: el saldo no cubre las reservas en curso más la estimación de esta tarea; si falta cuota de miembro, message empieza por Insufficient quota:

404El modelo no está en el grupo de esta clave: The current group does not support the requested model: <ID del modelo>

413El cuerpo de la solicitud supera el límite

503Los medios de referencia no se descargaron ni analizaron en 2 minutos (upstream_timeout, media validation timed out, please retry later); reintente más tarde sin cambios

Encabezados

Parámetros del cuerpoJSON

Respuesta

Errores

Páginas relacionadas