API 参考

查询持久视频历史

GET/v1/videos

只列 persistent 未删除记录;同账户同 Key,账务及存储独立,历史读取不承诺与生成相同模型策略。

鉴权与权限

使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。

Authorization: Bearer $GLOOP_API_KEY

鉴权方案: BearerAuth

请求

查询参数

  • qstring选填

    提示词搜索。

  • modelstring选填

    公开模型 ID。

  • statusstring选填

    queued/processing/succeeded/failed/unknown 过滤。

  • cursorstring选填

    原响应 next_cursor。

  • frominteger选填

    Unix 秒时间界限,from <= to。

    最小值
    0
  • tointeger选填

    Unix 秒时间界限,from <= to。

    最小值
    0
  • limitinteger选填

    每页数量。

    默认值
    20
    最小值
    1
    最大值
    50

响应与错误

HTTP 200

查询持久视频历史成功

application/json

类型
object
必填字段
data
  • dataarray必填

    当前页/目录数据数组。

    data 子字段(1)
    • []object选填
      [] 子字段(12)
      • updated_atinteger选填

        Unix 秒最后更新时间。

      • retentionstring选填

        任务结果保留策略,persistent 是持久工作区。

      • inputobject选填

        原始任务输入或工具契约输入。

        input 子字段(14)
        • modestring选填

          persistent 必填。

          枚举
          ["text_to_video","image_to_video"]
        • retentionstring选填

          persistent 使用持久工作区;省略为普通任务。

        • quote_idstring选填

          persistent 新请求须先确认 video-quotes 返回的有效报价。

        • start_frameobject选填

          persistent 图生视频必填,同 Key 的托管文件;文生视频禁止。

          start_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • end_frameobject选填

          persistent 可选尾帧,能力必须支持。

          end_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • 普通任务可引用控制台已配置的接收端;persistent 禁止。

        • modelstring必填

          来自当前 Key 目录的公开模型 ID,历史模型是否可用以当前目录为准。

        • promptstring必填

          生成提示词。

          最短长度
          1
          最长长度
          2500
        • durationinteger选填

          模型相关秒数,使用 video-models mode.presets 的完整组合,不能作笛卡尔积。Wan Turbo 不支持此字段;无统一默认。

        • image_urlstring选填

          仅普通任务模型相关 HTTPS 首帧;persistent 禁止。

        • end_image_urlstring选填

          仅普通任务模型相关 HTTPS 尾帧;persistent 禁止。

        • resolutionstring选填

          模型 preset 中的分辨率值。

        • aspect_ratiostring选填

          模型 preset 中的宽高比值。

        • generate_audioboolean选填允许 null

          模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。

        allOf 分支 1

        类型: object

        分支必填: model, prompt

        额外属性: false

        • modestring选填

          persistent 必填。

          枚举
          ["text_to_video","image_to_video"]
        • retentionstring选填

          persistent 使用持久工作区;省略为普通任务。

        • quote_idstring选填

          persistent 新请求须先确认 video-quotes 返回的有效报价。

        • start_frameobject选填

          persistent 图生视频必填,同 Key 的托管文件;文生视频禁止。

          start_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • end_frameobject选填

          persistent 可选尾帧,能力必须支持。

          end_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • 普通任务可引用控制台已配置的接收端;persistent 禁止。

        • modelstring必填

          来自当前 Key 目录的公开模型 ID,历史模型是否可用以当前目录为准。

        • promptstring必填

          生成提示词。

          最短长度
          1
          最长长度
          2500
        • durationinteger选填

          模型相关秒数,使用 video-models mode.presets 的完整组合,不能作笛卡尔积。Wan Turbo 不支持此字段;无统一默认。

        • image_urlstring选填

          仅普通任务模型相关 HTTPS 首帧;persistent 禁止。

        • end_image_urlstring选填

          仅普通任务模型相关 HTTPS 尾帧;persistent 禁止。

        • resolutionstring选填

          模型 preset 中的分辨率值。

        • aspect_ratiostring选填

          模型 preset 中的宽高比值。

        • generate_audioboolean选填允许 null

          模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。

      • billingobject选填

        独立账务状态,不用生成状态代替。

        billing 子字段(7)
        • currencystring必填

          报价/账务币种。

        • error_codestring选填

          可用于分支处理的公开错误码。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • reserved_quotainteger必填

          以平台 quota 单位表示的预留额度,不是美元数。

        • final_quotainteger必填允许 null

          以平台 quota 单位表示的最终费用;null 表示尚未确定。

        • reserved_amountstring必填

          报价币种中的最大预留金额字符串。

        • final_amountstring必填允许 null

          最终费用字符串,null 表示未结清。

        allOf 分支 1

        类型: object

        分支必填: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

        • currencystring必填

          报价/账务币种。

        • error_codestring选填

          可用于分支处理的公开错误码。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • reserved_quotainteger必填

          以平台 quota 单位表示的预留额度,不是美元数。

        • final_quotainteger必填允许 null

          以平台 quota 单位表示的最终费用;null 表示尚未确定。

        • reserved_amountstring必填

          报价币种中的最大预留金额字符串。

        • final_amountstring必填允许 null

          最终费用字符串,null 表示未结清。

      • storageobject选填

        独立文件保存状态。

        storage 子字段(3)
        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • error_codestring选填

          可用于分支处理的公开错误码。

        allOf 分支 1

        类型: object

        分支必填: status

        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • error_codestring选填

          可用于分支处理的公开错误码。

      • availabilityobject选填

        当前操作能力。

        availability 子字段(4)
        • can_cancelboolean必填

          当前任务是否允许请求取消。

        • can_deleteboolean必填

          当前任务是否允许删除。

        • can_retry_storageboolean必填

          当前任务是否允许重试保存。

        • reasonstring选填

          不可操作或账务复核的公开理由。

        allOf 分支 1

        类型: object

        分支必填: can_cancel, can_delete, can_retry_storage

        • can_cancelboolean必填

          当前任务是否允许请求取消。

        • can_deleteboolean必填

          当前任务是否允许删除。

        • can_retry_storageboolean必填

          当前任务是否允许重试保存。

        • reasonstring选填

          不可操作或账务复核的公开理由。

      • idstring必填

        该对象的公开标识符;用于对应详情路径。

      • modelstring必填

        当前 Key 目录中的公开模型 ID。

      • statusstring必填

        普通任务及持久任务状态;可能 pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown。最终状态不等于账务结清和归档 ready。

      • created_atinteger必填

        Unix 秒创建时间。

      • resultobject选填

        已准备的结果元数据,未完成时可能不存在。

        result 子字段(8)
        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • storage_statusstring选填

          文件归档状态,ready 后才保证托管下载可用。

        • deliverystring选填

          authenticated_content 表示须使用内容路径,不能假定存在直接 URL。

        • content_pathstring选填

          平台认证内容路径,使用相同 Key 请求二进制。

        • urlstring选填

          结果或引用的访问 URL;签名 URL 仅短时有效。

        • content_typestring选填

          结果 MIME 类型。

        • file_namestring选填

          公开下载文件名。

        • file_sizeinteger选填

          结果文件字节数。

        allOf 分支 1

        类型: object

        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • storage_statusstring选填

          文件归档状态,ready 后才保证托管下载可用。

        • deliverystring选填

          authenticated_content 表示须使用内容路径,不能假定存在直接 URL。

        • content_pathstring选填

          平台认证内容路径,使用相同 Key 请求二进制。

        • urlstring选填

          结果或引用的访问 URL;签名 URL 仅短时有效。

        • content_typestring选填

          结果 MIME 类型。

        • file_namestring选填

          公开下载文件名。

        • file_sizeinteger选填

          结果文件字节数。

      • errorstring选填

        公开失败分类或错误对象。

      allOf 分支 1

      类型: object

      分支必填: id, model, status, created_at

      • updated_atinteger选填

        Unix 秒最后更新时间。

      • retentionstring选填

        任务结果保留策略,persistent 是持久工作区。

      • inputobject选填

        原始任务输入或工具契约输入。

        input 子字段(14)
        • modestring选填

          persistent 必填。

          枚举
          ["text_to_video","image_to_video"]
        • retentionstring选填

          persistent 使用持久工作区;省略为普通任务。

        • quote_idstring选填

          persistent 新请求须先确认 video-quotes 返回的有效报价。

        • start_frameobject选填

          persistent 图生视频必填,同 Key 的托管文件;文生视频禁止。

          start_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • end_frameobject选填

          persistent 可选尾帧,能力必须支持。

          end_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • 普通任务可引用控制台已配置的接收端;persistent 禁止。

        • modelstring必填

          来自当前 Key 目录的公开模型 ID,历史模型是否可用以当前目录为准。

        • promptstring必填

          生成提示词。

          最短长度
          1
          最长长度
          2500
        • durationinteger选填

          模型相关秒数,使用 video-models mode.presets 的完整组合,不能作笛卡尔积。Wan Turbo 不支持此字段;无统一默认。

        • image_urlstring选填

          仅普通任务模型相关 HTTPS 首帧;persistent 禁止。

        • end_image_urlstring选填

          仅普通任务模型相关 HTTPS 尾帧;persistent 禁止。

        • resolutionstring选填

          模型 preset 中的分辨率值。

        • aspect_ratiostring选填

          模型 preset 中的宽高比值。

        • generate_audioboolean选填允许 null

          模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。

        allOf 分支 1

        类型: object

        分支必填: model, prompt

        额外属性: false

        • modestring选填

          persistent 必填。

          枚举
          ["text_to_video","image_to_video"]
        • retentionstring选填

          persistent 使用持久工作区;省略为普通任务。

        • quote_idstring选填

          persistent 新请求须先确认 video-quotes 返回的有效报价。

        • start_frameobject选填

          persistent 图生视频必填,同 Key 的托管文件;文生视频禁止。

          start_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • end_frameobject选填

          persistent 可选尾帧,能力必须支持。

          end_frame 子字段(1)
          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

          allOf 分支 1

          类型: object

          分支必填: file_id

          • file_idstring必填

            同账户同 Key 的托管文件公开 ID。

        • 普通任务可引用控制台已配置的接收端;persistent 禁止。

        • modelstring必填

          来自当前 Key 目录的公开模型 ID,历史模型是否可用以当前目录为准。

        • promptstring必填

          生成提示词。

          最短长度
          1
          最长长度
          2500
        • durationinteger选填

          模型相关秒数,使用 video-models mode.presets 的完整组合,不能作笛卡尔积。Wan Turbo 不支持此字段;无统一默认。

        • image_urlstring选填

          仅普通任务模型相关 HTTPS 首帧;persistent 禁止。

        • end_image_urlstring选填

          仅普通任务模型相关 HTTPS 尾帧;persistent 禁止。

        • resolutionstring选填

          模型 preset 中的分辨率值。

        • aspect_ratiostring选填

          模型 preset 中的宽高比值。

        • generate_audioboolean选填允许 null

          模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。

      • billingobject选填

        独立账务状态,不用生成状态代替。

        billing 子字段(7)
        • currencystring必填

          报价/账务币种。

        • error_codestring选填

          可用于分支处理的公开错误码。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • reserved_quotainteger必填

          以平台 quota 单位表示的预留额度,不是美元数。

        • final_quotainteger必填允许 null

          以平台 quota 单位表示的最终费用;null 表示尚未确定。

        • reserved_amountstring必填

          报价币种中的最大预留金额字符串。

        • final_amountstring必填允许 null

          最终费用字符串,null 表示未结清。

        allOf 分支 1

        类型: object

        分支必填: currency, status, reserved_quota, final_quota, reserved_amount, final_amount

        • currencystring必填

          报价/账务币种。

        • error_codestring选填

          可用于分支处理的公开错误码。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • reserved_quotainteger必填

          以平台 quota 单位表示的预留额度,不是美元数。

        • final_quotainteger必填允许 null

          以平台 quota 单位表示的最终费用;null 表示尚未确定。

        • reserved_amountstring必填

          报价币种中的最大预留金额字符串。

        • final_amountstring必填允许 null

          最终费用字符串,null 表示未结清。

      • storageobject选填

        独立文件保存状态。

        storage 子字段(3)
        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • error_codestring选填

          可用于分支处理的公开错误码。

        allOf 分支 1

        类型: object

        分支必填: status

        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • statusstring必填

          对象当前状态;必须与账务和保存阶段分别判断。

        • error_codestring选填

          可用于分支处理的公开错误码。

      • availabilityobject选填

        当前操作能力。

        availability 子字段(4)
        • can_cancelboolean必填

          当前任务是否允许请求取消。

        • can_deleteboolean必填

          当前任务是否允许删除。

        • can_retry_storageboolean必填

          当前任务是否允许重试保存。

        • reasonstring选填

          不可操作或账务复核的公开理由。

        allOf 分支 1

        类型: object

        分支必填: can_cancel, can_delete, can_retry_storage

        • can_cancelboolean必填

          当前任务是否允许请求取消。

        • can_deleteboolean必填

          当前任务是否允许删除。

        • can_retry_storageboolean必填

          当前任务是否允许重试保存。

        • reasonstring选填

          不可操作或账务复核的公开理由。

      • idstring必填

        该对象的公开标识符;用于对应详情路径。

      • modelstring必填

        当前 Key 目录中的公开模型 ID。

      • statusstring必填

        普通任务及持久任务状态;可能 pending_dispatch/submitting/queued/processing/succeeded/failed/cancelled/unknown。最终状态不等于账务结清和归档 ready。

      • created_atinteger必填

        Unix 秒创建时间。

      • resultobject选填

        已准备的结果元数据,未完成时可能不存在。

        result 子字段(8)
        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • storage_statusstring选填

          文件归档状态,ready 后才保证托管下载可用。

        • deliverystring选填

          authenticated_content 表示须使用内容路径,不能假定存在直接 URL。

        • content_pathstring选填

          平台认证内容路径,使用相同 Key 请求二进制。

        • urlstring选填

          结果或引用的访问 URL;签名 URL 仅短时有效。

        • content_typestring选填

          结果 MIME 类型。

        • file_namestring选填

          公开下载文件名。

        • file_sizeinteger选填

          结果文件字节数。

        allOf 分支 1

        类型: object

        • file_idstring选填

          同账户同 Key 的托管文件公开 ID。

        • storage_statusstring选填

          文件归档状态,ready 后才保证托管下载可用。

        • deliverystring选填

          authenticated_content 表示须使用内容路径,不能假定存在直接 URL。

        • content_pathstring选填

          平台认证内容路径,使用相同 Key 请求二进制。

        • urlstring选填

          结果或引用的访问 URL;签名 URL 仅短时有效。

        • content_typestring选填

          结果 MIME 类型。

        • file_namestring选填

          公开下载文件名。

        • file_sizeinteger选填

          结果文件字节数。

      • errorstring选填

        公开失败分类或错误对象。

  • next_cursorstring选填

    下一页游标,原样用于该接口的分页参数;空值表示末页。

HTTP 400

请求字段或参数无效。

application/json

类型
object
必填字段
error

HTTP 401

Key 缺失、无效、过期或已撤销。

application/json

类型
object
必填字段
error

HTTP 403

IP、账户、模型或工具权限不足。

application/json

类型
object
必填字段
error

HTTP 404

对象/能力不可用,或功能开关关闭。

application/json

类型
object
必填字段
error

HTTP 409

幂等/报价冲突、对象未准备或仍被引用。

application/json

类型
object
必填字段
error

HTTP 429

请求/队列限流。

application/json

类型
object
必填字段
error

HTTP 500

鉴权或数据存储内部失败。

application/json

类型
object
必填字段
error

HTTP 503

服务、定价或存储不可用。

application/json

类型
object
必填字段
error