Consultar una tarea de video
Consulta el estado y las direcciones de resultado de una tarea de video (y de imágenes de Kling y Midjourney).
/v1/video/tasks/{task_id}Consulte periódicamente con el ID de tarea devuelto al enviar; se recomienda cada 5 segundos. Las consultas no ocupan concurrencia ni se facturan. Las respuestas de Seedance / Grok vienen envueltas en task; las de MiniMax / Kling son campos de nivel superior: no lea el nivel equivocado.
Una tarea de Seedance que sigue sin terminar más de 24 horas después de crearse se marca automáticamente como fallida (sin facturar), con task.error.message igual a The task did not finish within 24 hours and was terminated automatically. Las direcciones del resultado son direcciones firmadas bajo api.hop-base.com; las consultas posteriores devuelven la misma dirección y no se renuevan: todos los enlaces de resultado (Seedance, Grok, Kling y MiniMax por igual) son válidos durante 24 horas desde que se completa la tarea; descárguelos y guárdelos cuanto antes. Las tareas sin terminar se marcan como fallidas tras 24 horas (Seedance) o 2 horas (Kling, MiniMax).
Encabezados
Bearer sk-…: una clave de API creada en la consola; su grupo debe incluir el modelo solicitado
Parámetros de ruta
ID de tarea devuelto al enviar: vt… (Seedance / Grok), mmt… (MiniMax), kt… (Kling)
Respuesta
200Objeto de tarea (incluidas las fallidas)
Tarea
vt…
ID del modelo
Solo puede tomar estos cuatro valores; lea outputs solo cuando sea completed
Valorespendingprocessingcompletedfailed
Segundos del video; en tareas con duración automática, léalo al terminar
Direcciones del video (array de cadenas, no objetos {url}); direcciones firmadas de api.hop-base.com, válidas 24 horas desde que termina la tarea, sin renovación; al caducar devuelven 410
Opcional; solo aparece si se obtuvo el último fotograma; se vuelve a firmar en cada consulta
Opcional; son tokens, no un importe
Tokens facturados
Total
Si falla, {"message": "<English failure reason>"}; los enlaces se reemplazan por [URL_REDACTED]
RFC 3339
null mientras no termina
Solo aparece cuando la tarea termina, y solo para la clave que la creó. 0 significa que falló y no se cobró
Cargo de esta tarea en CNY (el mismo cargo que cost_usd)
Importe en USD realmente descontado del saldo por esta tarea, el mismo que su registro de uso
Moneda de cost, siempre CNY
mmt… / kt…
queued → processing → completed | failed; solo los dos últimos son finales; cualquier otro valor se trata como en curso
Dirección del video; válida 24 horas desde que termina la tarea, sin renovación; al caducar devuelve 410
Motivo del fallo; Kling incluye un error.code estable (como input_sensitive o generation_failed)
Descripción en inglés
Solo Kling
Detalle de facturación + importe cobrado
Nivel de facturación de MiniMax
Segundos facturados de MiniMax
Segundos de video de referencia de entrada en MiniMax
Imágenes de referencia de MiniMax por encima de la cantidad gratuita
Cargo de esta tarea en CNY (el mismo cargo que cost_usd)
Importe en USD realmente descontado del saldo por esta tarea, el mismo que su registro de uso
Moneda de cost, siempre CNY
Errores
missing_api_key / invalid_api_key / api_key_expired)