Skip to main content
POST
读取已保存输出的元数据。设置 includeContent=true 可获取完整的结构化 JSON,包括所有字幕词语或转写文本。

身份验证和权限

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

参数

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)$.
boolean
布尔值。默认值: false.
以下 JSON Schema 保留了发现接口公开的确切字段名、嵌套类型、默认值、范围和可接受值。其他跨字段规则列于操作说明中。

请求示例

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

响应

首次执行成功时返回 HTTP 200,操作结果位于 data 下。重放请求时可能改为返回已保存的请求状态。示例展示了一种支持的响应,并未包含所有可选字段。 已保存的输出元数据;includeContent 为 true 时还包含完整的结构化结果。省略 includeContent 时仅返回元数据。

结果字段

操作说明

  • 需要付费订阅和操作权限。执行时会重新检查调用者的个人工具套餐;已保存的工具和上传引用均属于该调用者,包括凭据与团队关联时。
  • 成功操作会消耗一次 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 元数据表示输出持久化需要恢复。读取内容或下载时会尝试恢复已保存的加密对象;开始另一次生成前,请先检查该对象。
  • includeContent 默认为 false。设为 true 时,会解密并在 result 下返回完整的生成 JSON。此示例展示返回内容的形式。
  • 嵌套 result 的结构遵循其原始操作。转写输出包含转写文本,字幕输出可能包含 SRT/已渲染视频数据,字幕词条包含单词文本、startMs/endMs、可为 null 的 speakerId 和 durationSeconds。

用量

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

错误