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).

GET/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: 30 días para Seedance y Grok, 6 horas para Kling y MiniMax; descárguelas y guárdelas dentro del plazo. Las tareas sin terminar se marcan como fallidas tras 24 horas (Seedance) o 2 horas (Kling, MiniMax).

Consultar una tarea de video

curl https://api.hop-base.com/v1/video/tasks/vtEXAMPLE \
  -H "Authorization: Bearer $HOPBASE_API_KEY"

200application/json

{
  "task": {
    "id": "vtEXAMPLE",
    "model": "dreamina-seedance-2-5-260628",
    "status": "completed",
    "duration_seconds": 5,
    "outputs": [
      "https://api.hop-base.com/example-signed-video.mp4"
    ],
    "last_frame_url": "https://api.hop-base.com/example-signed-last-frame.jpg",
    "usage": {
      "completion_tokens": 1000,
      "total_tokens": 1000
    },
    "error": null,
    "created_at": "2026-09-23T08:00:00Z",
    "completed_at": "2026-09-23T08:03:10Z"
  },
  "usage": {
    "cost": 3.4,
    "currency": "CNY",
    "cost_cny": 3.4,
    "cost_usd": 0.5
  }
}

Encabezados

Authorization:obligatoriostring

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

Parámetros de ruta

task_id:obligatoriostring

ID de tarea devuelto al enviar: vt… (Seedance / Grok), mmt… (MiniMax), kt… (Kling)

Respuesta

200Objeto de tarea (incluidas las fallidas)

Familia

task:opcionalobject

Tarea

usage:opcionalobject

Solo aparece cuando la tarea termina, y solo para la clave que la creó. 0 significa que falló y no se cobró

Errores

401Falta la clave, la clave no es válida o ha caducado (missing_api_key / invalid_api_key / api_key_expired)

404La tarea no existe o no pertenece a esta clave

Encabezados

Parámetros de ruta

Respuesta

Errores

Páginas relacionadas