Skip to main content
GET
监听渲染
服务先发送状态快照,再每 10–15 秒发送心跳,进入 readyfailedcancelled 后关闭流。断开后可使用 Last-Event-ID 恢复快照后的事件。若事件历史已过期,先调用获取视频GET /v1/videos/{render_id})读取当前状态,再重新连接。

请求参数

响应

返回 200 OKtext/event-stream 响应体。业务事件的 data 为 JSON,心跳可能不带 data 渲染事件的 data 字段如下:

示例

能够保持长连接时,可使用本接口减少获取视频的轮询延迟与请求量,状态判断方式不变。

下一步

收到 ready 事件后,使用下载渲染结果,或直接读取事件中的 video_url/alpha_url

Authorizations

Authorization
string
header
required

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

Headers

Last-Event-ID
string

客户端最后完整处理的 SSE 事件 ID。重连时传入,以便在历史仍保留时从该事件之后继续。

Minimum string length: 1
X-Request-Id
string

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

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

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

Required string length: 1 - 128

Path Parameters

render_id
string
required

创建或列出渲染时返回的公开 ID,通常以 render_ 开头,必须属于当前调用者。

Minimum string length: 1

Response

请求成功。

UTF-8 编码的服务器发送事件流。