API 参考
查询持久视频历史
/v1/videos只列 persistent 未删除记录;同账户同 Key,账务及存储独立,历史读取不承诺与生成相同模型策略。
鉴权与权限
使用当前 GloopAPI Key。模型、功能与权限以当前 Key 的目录及接口说明为准。
Authorization: Bearer $GLOOP_API_KEY鉴权方案: BearerAuth
请求
查询参数
响应与错误
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。
end_frameobject选填persistent 可选尾帧,能力必须支持。
end_frame 子字段(1)
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 中的宽高比值。
模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。
allOf 分支 1
类型: object
分支必填: model, prompt
额外属性:
falsemodestring选填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。
end_frameobject选填persistent 可选尾帧,能力必须支持。
end_frame 子字段(1)
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 中的宽高比值。
模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。
billingobject选填独立账务状态,不用生成状态代替。
billing 子字段(7)
currencystring必填报价/账务币种。
error_codestring选填可用于分支处理的公开错误码。
statusstring必填对象当前状态;必须与账务和保存阶段分别判断。
reserved_quotainteger必填以平台 quota 单位表示的预留额度,不是美元数。
以平台 quota 单位表示的最终费用;null 表示尚未确定。
reserved_amountstring必填报价币种中的最大预留金额字符串。
最终费用字符串,null 表示未结清。
allOf 分支 1
类型: object
分支必填: currency, status, reserved_quota, final_quota, reserved_amount, final_amount
currencystring必填报价/账务币种。
error_codestring选填可用于分支处理的公开错误码。
statusstring必填对象当前状态;必须与账务和保存阶段分别判断。
reserved_quotainteger必填以平台 quota 单位表示的预留额度,不是美元数。
以平台 quota 单位表示的最终费用;null 表示尚未确定。
reserved_amountstring必填报价币种中的最大预留金额字符串。
最终费用字符串,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。
end_frameobject选填persistent 可选尾帧,能力必须支持。
end_frame 子字段(1)
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 中的宽高比值。
模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。
allOf 分支 1
类型: object
分支必填: model, prompt
额外属性:
falsemodestring选填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。
end_frameobject选填persistent 可选尾帧,能力必须支持。
end_frame 子字段(1)
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 中的宽高比值。
模型相关,使用模式的音频策略和 presets;禁止假定所有模型生成音频。
billingobject选填独立账务状态,不用生成状态代替。
billing 子字段(7)
currencystring必填报价/账务币种。
error_codestring选填可用于分支处理的公开错误码。
statusstring必填对象当前状态;必须与账务和保存阶段分别判断。
reserved_quotainteger必填以平台 quota 单位表示的预留额度,不是美元数。
以平台 quota 单位表示的最终费用;null 表示尚未确定。
reserved_amountstring必填报价币种中的最大预留金额字符串。
最终费用字符串,null 表示未结清。
allOf 分支 1
类型: object
分支必填: currency, status, reserved_quota, final_quota, reserved_amount, final_amount
currencystring必填报价/账务币种。
error_codestring选填可用于分支处理的公开错误码。
statusstring必填对象当前状态;必须与账务和保存阶段分别判断。
reserved_quotainteger必填以平台 quota 单位表示的预留额度,不是美元数。
以平台 quota 单位表示的最终费用;null 表示尚未确定。
reserved_amountstring必填报价币种中的最大预留金额字符串。
最终费用字符串,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
errorobject必填error 子字段(4)
codestring选填messagestring选填typestring选填request_idstring选填
HTTP 401
Key 缺失、无效、过期或已撤销。
application/json
- 类型
- object
- 必填字段
error
errorobject必填error 子字段(4)
codestring选填messagestring选填typestring选填request_idstring选填
HTTP 403
IP、账户、模型或工具权限不足。
application/json
- 类型
- object
- 必填字段
error
errorobject必填error 子字段(4)
codestring选填messagestring选填typestring选填request_idstring选填
HTTP 404
对象/能力不可用,或功能开关关闭。
application/json
- 类型
- object
- 必填字段
error
errorobject必填error 子字段(4)
codestring选填messagestring选填typestring选填request_idstring选填
HTTP 409
幂等/报价冲突、对象未准备或仍被引用。
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 503
服务、定价或存储不可用。
application/json
- 类型
- object
- 必填字段
error
errorobject必填error 子字段(4)
codestring选填messagestring选填typestring选填request_idstring选填