Referencia de API

Consultar historial de vídeos persistentes

GET/v1/videos

Solo registros persistent no eliminados de la misma cuenta y clave. Facturación y almacenamiento son independientes; leer historial no garantiza la misma política de modelos que generar.

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 consulta

  • qstringOpcional

    Búsqueda de prompt.

  • modelstringOpcional

    ID público de modelo.

  • statusstringOpcional

    Filtro queued/processing/succeeded/failed/unknown.

  • cursorstringOpcional

    next_cursor de la respuesta original.

  • fromintegerOpcional

    Límites temporales en segundos Unix, from <= to.

    Mínimo
    0
  • tointegerOpcional

    Límites temporales en segundos Unix, from <= to.

    Mínimo
    0
  • limitintegerOpcional

    Cantidad por página.

    Valor predeterminado
    20
    Mínimo
    1
    Máximo
    50

Respuestas y errores

HTTP 200

Historial de vídeos persistentes consultado correctamente

application/json

Tipo
object
Campos obligatorios
data
  • dataarrayObligatorio

    Matriz de datos de página/catálogo actual.

    Campos secundarios de data (1)
    • []objectOpcional
      Campos secundarios de [] (12)
      • 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.

      Rama allOf 1

      Tipo: object

      Obligatorio en esta rama: id, model, status, created_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.

  • next_cursorstringOpcional

    Cursor siguiente; úsalo sin cambios en la paginación de este endpoint. Vacío indica última página.

HTTP 400

Campos o parámetros de solicitud inválidos.

application/json

Tipo
object
Campos obligatorios
error

HTTP 401

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

application/json

Tipo
object
Campos obligatorios
error

HTTP 403

Permisos insuficientes de IP, cuenta, modelo o herramienta.

application/json

Tipo
object
Campos obligatorios
error

HTTP 404

Objeto/capacidad no disponible o función desactivada.

application/json

Tipo
object
Campos obligatorios
error

HTTP 409

Conflicto de idempotencia/cotización, objeto no preparado o aún referenciado.

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 503

Servicio, precios o almacenamiento no disponibles.

application/json

Tipo
object
Campos obligatorios
error