Skip to main content
POST
列出已保存的集成输出,包括无法容纳在操作轮询响应中的大型结果。将 nextCursor 作为 beforeResultId 传入。

身份验证和权限

string
必填
在此请求头中发送 VoiceCheap API 密钥。也支持通过 Authorization: Bearer 发送同一 API 密钥。OAuth 访问令牌仅适用于 MCP,此 REST 端点不接受 OAuth 访问令牌。
所需权限: transcription:read. 需要有效的付费订阅。权限不会改变团队角色、资源归属、媒体额度或套餐限制。

参数

integer
整数值。最小值: 1. 最大值: 100. 默认值: 30.
string
文本值。格式: “uuid”. 匹配模式: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$.
以下 JSON Schema 保留了发现接口公开的确切字段名、嵌套类型、默认值、范围和可接受值。其他跨字段规则列于操作说明中。

请求示例

请将示例资源标识符和媒体键替换为账户返回的值。重试同一次修改操作时,请保持请求标识符不变。

响应

首次执行成功时返回 HTTP 200,操作结果位于 data 下。重放请求时可能改为返回已保存的请求状态。示例展示了一种支持的响应,并未包含所有可选字段。 当前账户拥有的集成结果元数据分页列表。每个条目均提供获取完整输出所需的操作。

结果字段

操作说明

  • 需要付费订阅和操作权限。执行时会重新检查调用者的个人工具套餐;已保存的工具和上传引用均属于该调用者,包括凭据与团队关联时。
  • 成功操作会消耗一次 API/MCP 共用的每月调用次数。Beginner 每月 500 次、Starter 5,000 次、Creator 25,000 次;Pro、Scale 和 Enterprise 无每月上限。每分钟限制仍然适用,分别为 30、60、120、180、300 和 600 次。工具生成限额单独计算。
  • resultId 是来自已完成生成的引用或此域 result_list 的 UUID。它不同于操作的 requestId 和网页工具的 historyId。
  • 结果归属于经过身份验证的调用者和权限域。无法通过 transcription 操作读取 subtitles 结果,反之亦然。
  • 完整的已保存 JSON 采用静态加密存储,独立于保留范围有限的操作轮询缓存。获取时仍需认证;不会提供公开的转写文本或字幕 JSON URL。
  • 这些操作获取现有输出,不会生成媒体或使用每日限额。每次成功获取仍会消耗一次每月集成调用。
  • pending 元数据表示输出持久化需要恢复。读取内容或下载时会尝试恢复已保存的加密对象;开始另一次生成前,请先检查该对象。
  • limit 默认为 30,接受 1 至 100。结果按 createdAt 降序排列。将 nextCursor 作为 beforeResultId 传入可获取下一页;null 表示已到末尾。
  • 条目同时包括待处理和已完成的元数据。列表条目不包含生成的文本、字幕词语、存储键或加密材料。

用量

每次成功调用消耗一次月度 API/MCP 调用额度。媒体额度和操作本身的生成限额也适用。

错误