API 参考

查询视频任务状态

GET/v1/videos/{task_id}

查询状态；生成成功、billing.status 与 storage.status 必须独立判断。有效耗尽 Key 可查任务，当前模型授权按该实现检查。

鉴权与权限

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

Authorization: Bearer $GLOOP_API_KEY

鉴权方案： BearerAuth

请求

路径参数

task_idstring必填
同 Key 创建的任务公开 ID。

响应与错误

HTTP 200

请求成功。

application/json

类型: object
必填字段: idmodelstatuscreated_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。
- webhook_endpoint_idstring选填
  普通任务可引用控制台已配置的接收端；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。
- webhook_endpoint_idstring选填
  普通任务可引用控制台已配置的接收端；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选填
公开失败分类或错误对象。

HTTP 401

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 403

当前 Key 无权限。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（3）
- messagestring必填
- typestring必填
  枚举
  ["new_api_error"]
- codestring必填

HTTP 404

对象或能力不可用。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（3）
- messagestring必填
- typestring必填
  枚举
  ["new_api_error"]
- codestring必填

HTTP 409

请求冲突、未准备或提交未知，先查询原记录，禁止盲重发。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（3）
- messagestring必填
- typestring必填
  枚举
  ["new_api_error"]
- codestring必填

HTTP 410

视频任务已删除（task_deleted），不可继续读取。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 429

请求/队列限流。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 500

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（4）
- codestring选填
- messagestring选填
- typestring选填
- request_idstring选填

HTTP 502

服务响应异常。

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（3）
- messagestring必填
- typestring必填
  枚举
  ["new_api_error"]
- codestring必填

HTTP 503

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

application/json

类型: object
必填字段: error

errorobject必填
error 子字段（3）
- messagestring必填
- typestring必填
  枚举
  ["new_api_error"]
- codestring必填