Skip to main content
GET
列出视频
通过不透明游标分页返回当前身份拥有的视频,按 created_at 从新到旧排列。列表合并三种来源:通过渲染视频创建的 render_;通过文本首帧首尾帧参考素材生成的 H3 vid_;以及使用 Viggle-Animate生成的 anim_。本接口替代已停用的 GET /v1/renders
GET /v1/renders 现返回 405 Method Not Allowed,而不是 404,因为同一路径仍支持 POST /v1/renders。如旧集成通过 404 判断接口已停用,请同时处理 405,或直接迁移到本接口。

请求参数

响应参数

返回 200 OK 摘要不包含签名媒体 URL 或失败详情;完整状态请调用获取视频

完成时间

Render 来源的视频在 status 变为 ready 后,completed_at 可能延迟约 30 秒回填,并非永久缺失。判断完成状态时应检查 status == "ready",不要依赖 completed_at 非空。

示例

继续分页时,将上一次响应中的 next_cursor 作为下一次请求的 cursor。当 has_morefalse 时停止。

下一步

使用任意 items[].id 调用获取视频,获取包括 video_url 在内的完整状态。

授权

Authorization
string
header
必填

服务端 SDK 使用项目 API 密钥,Remote MCP 使用 OAuth 访问令牌。不要在浏览器代码中暴露项目密钥。

请求头

X-Request-Id
string

可选的调用者自定义关联 ID,最长 128 字符。服务会在响应头返回实际使用的值,便于追踪和支持排查。

Required string length: 1 - 128
X-Viggle-Source
string

可选来源标签,最长 128 字符,用于识别 SDK、集成、产品入口或内部工作流。

Required string length: 1 - 128

查询参数

status
enum<string>

可选生命周期筛选。提供后仅返回当前状态与该值完全匹配的视频。 异步资源共用的公开生命周期,枚举值与 RenderStatus 相同。

可用选项:
queued,
processing,
ready,
failed,
cancelled
cursor
string

上一页 next_cursor 返回的不透明令牌,请原样传入,分页时保持其他筛选条件一致。

Required string length: 1 - 512
limit
integer
默认值:20

每页最多视频摘要数量,范围 1–100,默认 20。

必填范围: 1 <= x <= 100

响应

请求成功。

items
object[]
必填

本页的视频摘要,按创建时间倒序合并当前调用者的不同视频来源。

next_cursor
string | null
必填

下一页的不透明游标,无后续页时为 null。作为下次 cursor 查询参数原样传入。

has_more
boolean
必填

当前页之后是否还有下一页。