Documentación

Referencia de API

Consultar estado de tarea de vídeo

GET/v1/videos/{task_id}

Consulta estado; éxito, billing.status y storage.status son independientes. Claves válidas con cuota agotada pueden consultar; la autorización actual sigue esta implementación.

Autenticación y permisos

Usa tu clave actual de GloopAPI. Los modelos, capacidades y permisos dependen de su catálogo y de la documentación del endpoint.

Authorization: Bearer $GLOOP_API_KEY

Esquemas de autenticación: BearerAuth

Solicitud

Parámetros de ruta

  • task_idstringObligatorio

    ID público de tarea creada con la misma clave.

Respuestas y errores

HTTP 200

Solicitud correcta.

application/json

Tipo
object
Campos obligatorios
idmodelstatuscreated_at
  • updated_atintegerOpcional

    Última actualización en segundos Unix.

  • retentionstringOpcional

    Política de retención del resultado; persistent es el espacio persistente.

  • inputobjectOpcional

    Entrada original de tarea o del contrato de herramienta.

    Campos secundarios de input (14)
    • modestringOpcional

      Obligatorio en persistent.

      Enumeración
      ["text_to_video","image_to_video"]
    • retentionstringOpcional

      persistent usa el espacio persistente; omitirlo crea una tarea ordinaria.

    • quote_idstringOpcional

      Las nuevas solicitudes persistent deben confirmar primero una cotización válida de video-quotes.

    • start_frameobjectOpcional

      Obligatorio en imagen a vídeo persistent: archivo gestionado de la misma clave. Prohibido en texto a vídeo.

      Campos secundarios de start_frame (1)
      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

      Rama allOf 1

      Tipo: object

      Obligatorio en esta rama: file_id

      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

    • end_frameobjectOpcional

      Fotograma final opcional en persistent, si la capacidad lo admite.

      Campos secundarios de end_frame (1)
      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

      Rama allOf 1

      Tipo: object

      Obligatorio en esta rama: file_id

      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

    • webhook_endpoint_idstringOpcional

      Las tareas ordinarias pueden referenciar receptores de consola; persistent lo prohíbe.

    • modelstringObligatorio

      ID público del catálogo de la clave actual; no garantiza disponibilidad de modelos históricos del servicio.

    • promptstringObligatorio

      Prompt de generación.

      Longitud mínima
      1
      Longitud máxima
      2500
    • durationintegerOpcional

      Segundos según modelo; usa la combinación completa de video-models mode.presets, no producto cartesiano. Wan Turbo no admite este campo; sin valor predeterminado uniforme.

    • image_urlstringOpcional

      Fotograma inicial HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

    • end_image_urlstringOpcional

      Fotograma final HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

    • resolutionstringOpcional

      Resolución del preset del modelo.

    • aspect_ratiostringOpcional

      Relación de aspecto del preset del modelo.

    • generate_audiobooleanOpcionalAdmite null

      Según modelo, política de audio y presets del modo; no supongas que todos generan audio.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: model, prompt

    Propiedades adicionales: false

    • modestringOpcional

      Obligatorio en persistent.

      Enumeración
      ["text_to_video","image_to_video"]
    • retentionstringOpcional

      persistent usa el espacio persistente; omitirlo crea una tarea ordinaria.

    • quote_idstringOpcional

      Las nuevas solicitudes persistent deben confirmar primero una cotización válida de video-quotes.

    • start_frameobjectOpcional

      Obligatorio en imagen a vídeo persistent: archivo gestionado de la misma clave. Prohibido en texto a vídeo.

      Campos secundarios de start_frame (1)
      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

      Rama allOf 1

      Tipo: object

      Obligatorio en esta rama: file_id

      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

    • end_frameobjectOpcional

      Fotograma final opcional en persistent, si la capacidad lo admite.

      Campos secundarios de end_frame (1)
      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

      Rama allOf 1

      Tipo: object

      Obligatorio en esta rama: file_id

      • file_idstringObligatorio

        ID público de archivo gestionado de la misma cuenta y clave.

    • webhook_endpoint_idstringOpcional

      Las tareas ordinarias pueden referenciar receptores de consola; persistent lo prohíbe.

    • modelstringObligatorio

      ID público del catálogo de la clave actual; no garantiza disponibilidad de modelos históricos del servicio.

    • promptstringObligatorio

      Prompt de generación.

      Longitud mínima
      1
      Longitud máxima
      2500
    • durationintegerOpcional

      Segundos según modelo; usa la combinación completa de video-models mode.presets, no producto cartesiano. Wan Turbo no admite este campo; sin valor predeterminado uniforme.

    • image_urlstringOpcional

      Fotograma inicial HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

    • end_image_urlstringOpcional

      Fotograma final HTTPS público específico del modelo para tareas ordinarias; prohibido en persistent.

    • resolutionstringOpcional

      Resolución del preset del modelo.

    • aspect_ratiostringOpcional

      Relación de aspecto del preset del modelo.

    • generate_audiobooleanOpcionalAdmite null

      Según modelo, política de audio y presets del modo; no supongas que todos generan audio.

  • billingobjectOpcional

    Estado de facturación independiente, no sustituible por estado de generación.

    Campos secundarios de billing (7)
    • currencystringObligatorio

      Moneda de cotización/facturación.

    • error_codestringOpcional

      Código público de error para decisiones de flujo.

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • reserved_quotaintegerObligatorio

      Reserva en unidades quota de la plataforma, no en USD.

    • final_quotaintegerObligatorioAdmite null

      Cargo final en unidades quota de la plataforma; null indica que aún no se ha determinado.

    • reserved_amountstringObligatorio

      Reserva máxima como cadena en la moneda cotizada.

    • final_amountstringObligatorioAdmite null

      Cargo final como cadena; null indica sin liquidar.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

    • currencystringObligatorio

      Moneda de cotización/facturación.

    • error_codestringOpcional

      Código público de error para decisiones de flujo.

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • reserved_quotaintegerObligatorio

      Reserva en unidades quota de la plataforma, no en USD.

    • final_quotaintegerObligatorioAdmite null

      Cargo final en unidades quota de la plataforma; null indica que aún no se ha determinado.

    • reserved_amountstringObligatorio

      Reserva máxima como cadena en la moneda cotizada.

    • final_amountstringObligatorioAdmite null

      Cargo final como cadena; null indica sin liquidar.

  • storageobjectOpcional

    Estado independiente de guardado.

    Campos secundarios de storage (3)
    • file_idstringOpcional

      ID público de archivo gestionado de la misma cuenta y clave.

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • error_codestringOpcional

      Código público de error para decisiones de flujo.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: status

    • file_idstringOpcional

      ID público de archivo gestionado de la misma cuenta y clave.

    • statusstringObligatorio

      Estado actual del objeto; evalúalo aparte de facturación y guardado.

    • error_codestringOpcional

      Código público de error para decisiones de flujo.

  • availabilityobjectOpcional

    Acciones disponibles actualmente.

    Campos secundarios de availability (4)
    • can_cancelbooleanObligatorio

      Si la tarea actual permite solicitar cancelación.

    • can_deletebooleanObligatorio

      Si la tarea actual permite eliminarse.

    • can_retry_storagebooleanObligatorio

      Si la tarea actual permite reintentar el guardado.

    • reasonstringOpcional

      Motivo público de acción no disponible o revisión de facturación.

    Rama allOf 1

    Tipo: object

    Obligatorio en esta rama: can_cancel, can_delete, can_retry_storage

    • can_cancelbooleanObligatorio

      Si la tarea actual permite solicitar cancelación.

    • can_deletebooleanObligatorio

      Si la tarea actual permite eliminarse.

    • can_retry_storagebooleanObligatorio

      Si la tarea actual permite reintentar el guardado.

    • reasonstringOpcional

      Motivo público de acción no disponible o revisión de facturación.

  • idstringObligatorio

    Identificador público del objeto, usado en su ruta de detalles.

  • modelstringObligatorio

    ID público de modelo del catálogo de la clave actual.

  • statusstringObligatorio

    Estado ordinario/persistente: pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown. Un estado terminal no implica liquidación ni archivado ready.

  • created_atintegerObligatorio

    Fecha de creación en segundos Unix.

  • resultobjectOpcional

    Metadatos de resultados preparados; pueden no existir antes de finalizar.

    Campos secundarios de result (8)
    • file_idstringOpcional

      ID público de archivo gestionado de la misma cuenta y clave.

    • storage_statusstringOpcional

      Estado de archivado; descarga gestionada garantizada solo tras ready.

    • deliverystringOpcional

      authenticated_content exige usar la ruta de contenido; no supongas que existe una URL directa.

    • content_pathstringOpcional

      Ruta de contenido autenticada por la plataforma; solicita binario con la misma clave.

    • urlstringOpcional

      URL de acceso al resultado o referencia; firmadas solo válidas temporalmente.

    • content_typestringOpcional

      Tipo MIME del resultado.

    • file_namestringOpcional

      Nombre público del archivo descargado.

    • file_sizeintegerOpcional

      Bytes del archivo de resultado.

    Rama allOf 1

    Tipo: object

    • file_idstringOpcional

      ID público de archivo gestionado de la misma cuenta y clave.

    • storage_statusstringOpcional

      Estado de archivado; descarga gestionada garantizada solo tras ready.

    • deliverystringOpcional

      authenticated_content exige usar la ruta de contenido; no supongas que existe una URL directa.

    • content_pathstringOpcional

      Ruta de contenido autenticada por la plataforma; solicita binario con la misma clave.

    • urlstringOpcional

      URL de acceso al resultado o referencia; firmadas solo válidas temporalmente.

    • content_typestringOpcional

      Tipo MIME del resultado.

    • file_namestringOpcional

      Nombre público del archivo descargado.

    • file_sizeintegerOpcional

      Bytes del archivo de resultado.

  • errorstringOpcional

    Categoría pública de fallo u objeto de error.

HTTP 401

La clave falta, no es válida, caducó o fue revocada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

La clave actual no tiene permiso.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 404

Objeto o capacidad no disponible.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 409

Conflicto, no preparado o envío desconocido; consulta primero el original, sin reenviar a ciegas.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 410

La tarea de vídeo se eliminó (task_deleted) y no puede leerse.

application/json

Tipo
object
Campos obligatorios
error

HTTP 429

Límite de solicitudes/cola.

application/json

Tipo
object
Campos obligatorios
error

HTTP 500

Fallo interno de autenticación o almacenamiento de datos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 502

Error en la respuesta del servicio.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio

HTTP 503

Servicio, almacenamiento, precios temporalmente no disponibles.

application/json

Tipo
object
Campos obligatorios
error
  • errorobjectObligatorio
    Campos secundarios de error (3)
    • messagestringObligatorio
    • typestringObligatorio
      Enumeración
      ["new_api_error"]
    • codestringObligatorio