Яндекс.Метрика

公开 API

开发者文档与请求示例。

基础 URL

所有 API 请求均使用此基础 URL。

https://polyglotvoice.ru/api/v1

授权方式

所有请求都需要在 Authorization 标头中提供 API 密钥。

Authorization: Bearer sk_...

密钥有效期为 30 天，且仅适用于 transcriptions/* 端点。

如何获取 API 密钥

  1. 登录您的账户。
  2. 打开个人资料 → “API 密钥”。
  3. 创建密钥并保存（仅显示一次）。
  4. 在请求中使用该密钥。

终端 (Endpoints)

处理转录的核心终端。

POST /api/v1/transcriptions/upload

上传文件进行转录。

POST /api/v1/transcriptions/from-url

从媒体链接进行转录。

POST /api/v1/transcriptions/validate-url

在处理前验证媒体链接。

GET /api/v1/transcriptions

列出转录任务清单。

GET /api/v1/transcriptions/{task_id}

任务详情详情。

GET /api/v1/transcriptions/{task_id}/result

转录结果。

GET /api/v1/transcriptions/{task_id}/downloads/{kind}

下载结果文件（srt/txt/json 等）。

GET /api/v1/transcriptions/{task_id}/source

流式传输源媒体 (Range)。

POST /api/v1/transcriptions/convert-audio

转换音频并下载结果。

请求示例

快速上手的基本示例。

curl

curl -X POST "https://polyglotvoice.ru/api/v1/transcriptions/upload" \
  -H "Authorization: Bearer sk_..." \
  -F "file=@audio.mp3"

Python

import requests

url = "https://polyglotvoice.ru/api/v1/transcriptions/upload"
headers = {"Authorization": "Bearer sk_..."}
files = {"file": open("audio.mp3", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

const formData = new FormData();
formData.append("file", file);

fetch("https://polyglotvoice.ru/api/v1/transcriptions/upload", {
  method: "POST",
  headers: { Authorization: "Bearer sk_..." },
  body: formData
})
  .then((res) => res.json())
  .then(console.log);

文件格式

支持多种音视频格式。

例如：mp3, wav, m4a, ogg, mp4, webm。

响应和错误

任务创建响应和身份验证错误示例。

{ "task_id": "9b9c1b9a-....", "status": "queued" }
{ "detail": "Invalid token." }

限制

这些数值由 API 强制执行。短期（突发）限制适用于每个已登录用户 — 无论您使用会话 JWT 还是 sk_ 密钥，均视为同一账户。每日和每月计数器会统计使用您的任何 sk_ 密钥（按 UTC 日历日和月）发出的每个请求。当超过限制时，API 将返回 HTTP 429 响应。

实时字段 rate_limits 由以下接口返回：

GET https://polyglotvoice.ru/api/v1/developer/documentation

正在加载当前限制…

此外：每个方案还限制每个文件的最大音频长度、最大上传大小、并发任务数以及（网站端）每日上传次数。请在仪表板上查看您的订阅详情。