AudioGist
English登录免费开始

开发者 API

把 AudioGist 转录接入你的工作流

当前 v1 API 为所有付费方案提供最小权限的只读转录访问，不允许上传、修改、删除、账号或账单操作。

只读 v1下载 OpenAPI 3.1 JSON

Bearer 认证

在设置页创建 API Key。原始 key 只显示一次，之后只能看到安全前缀。每次请求都必须发送完整 Authorization Header。

不要把 API Key 写入浏览器代码、公开仓库、URL 或日志。服务端环境变量与 Secret Store 是推荐存储位置。

请求示例

curl -H "Authorization: Bearer $AUDIOGIST_API_KEY" \
  "https://api-staging.knovox.com/api/v1/transcripts?limit=25&offset=0"
GET

GET /api/v1/transcripts

分页读取当前 Key 所属用户的转录元数据。limit 为 1–100，默认 25；offset 为 0–10,000，默认 0。

GET

GET /api/v1/transcripts/:id

读取一条转录及其分段、结构化摘要和行动项。不存在或属于其他用户的 ID 均返回 404。

详情响应包含

  • transcript：来源、状态、语言、时长、说话人数、进度和时间字段。
  • segments：位置、毫秒时间戳、说话人、正文和可选置信度。
  • summary：模板键、概览、关键要点、关键词、带起始时间的内容章节、关键决策、带说话人/时间戳的原话摘录和模型；尚未生成时为 null。
  • actionItems：内容、可选负责人和完成状态。

错误与限流

  • 400 VALIDATION_ERROR：分页参数无效。
  • 401 INVALID_API_KEY：Key 缺失、格式错误、伪造、过期、撤销或账号已降级。
  • 403 INSUFFICIENT_SCOPE：Key 缺少 transcripts:read。
  • 404 TRANSCRIPT_NOT_FOUND：资源不存在或不属于 Key 用户。
  • 429 RATE_LIMITED：单 Key 每分钟 120 次读取上限；按照 Retry-After 重试。

所有响应都包含 X-Request-Id。联系支持时可以提供该值，但不要提供完整 API Key。