兼容 OpenAI 的 API 密钥:获取一个并发送调用
兼容 OpenAI 的 API 密钥是一个普通的 Bearer 令牌,只要将客户端指向不同的 Base URL,即可与任何 OpenAI SDK 配合使用。本页展示了如何在此站点的托管文本 API 上获取密钥,并在几分钟内发起有效请求。
已更新Speech To Text API

密钥的实际定义
“兼容 OpenAI”描述的是 HTTP API 的格式,而非背后的公司。该服务接受与 OpenAI SDK 发送的相同的 JSON 数据 POST /v1/chat/completions,并读取相同的 Authorization: Bearer 头部。因此,来自本服务的密钥可以无缝适配任何允许你设置自定义 Base URL 和 API 密钥的工具:官方 Python 和 Node 库、LangChain、纯 curl 以及大多数桌面聊天客户端。
该密钥不是 OpenAI 密钥,无法在 api.openai.com 上使用。反之亦然:OpenAI 密钥无法在此使用。每个密钥属于一个服务,此服务运行单一开放权重模型,针对在无内容拒绝的情况下进行回答进行了调优,适用于合法成人用途,由独立提供商托管。它不是任何模型供应商的官方 API,也不路由到其他供应商。
你需要记住以下几点。本站点的 Base URL 为 https://api.speechtotextapis.com/v1。模型 ID 为 uncensored。密钥是你注册后获得的任意字符串。以下内容都是基于这三个值的变体。
该服务仅支持文本。它处理聊天补全、流式输出、工具调用和 JSON 模式。它不生成图片或音频,不提供嵌入功能,也不微调模型。如果你来自语音流水线,典型任务通常是转录后的文本步骤:清理转录文本、将其拆分为场景、重写对话或提取结构化数据。语音脚本处理指南对此进行了更详细的介绍。
分四步获取密钥
- 注册。 使用 Google,或使用邮箱地址和密码注册。
- 打开 API 密钥页面。 它位于本站点的 密钥页面。你的密钥在此创建并显示。
- 领取试用额度。 同一页面上的一个按钮可让你一键获得 $0.50 的试用额度。每人限领一次,有效期 7 天,无需绑定信用卡。
- 将密钥复制到密钥库中。 对于本地测试,环境变量已足够。对于任何部署环境,请使用宿主机的密钥管理器。
试用旨在证明在付费之前集成能正常工作。按当前价格,它足以处理大量短请求,下方的成本部分展示了具体的算术计算。当你准备继续使用时,定价页面列出了充值金额。额度为预付,无订阅,且额度永不过期,因此无需在截止日期前因压力而花费充值额度。
试用密钥的限制比完整密钥更严格:2 个并发请求和每分钟 60 个请求。这对于第一个脚本来说已经足够。如果你计划并行分发数十个转录片段,预计会达到限制,直到你切换到已付费的账户。
每个客户端都必须设置的三个配置
无论你使用什么软件,设置屏幕都会以略微不同的名称询问相同的三个内容。
| 设置 | 典型字段名 | 说明 |
|---|---|---|
| 端点 | Base URL、API 基础地址、主机 | https://api.speechtotextapis.com/v1 |
| 凭证 | API 密钥、token、密钥 | 来自密钥页面的你的密钥 |
| 模型 | 模型、模型名称、引擎 | uncensored |
一个细节会让人们困惑:Base URL 已经以 /v1 结尾。SDK 会自动附加 /chat/completions,因此你不应该添加它。如果你的客户端要求聊天端点的完整 URL 而不是 Base URL,则值为 https://api.speechtotextapis.com/v1/chat/completions。
如果工具仅提供带有硬编码主机且无法编辑的“OpenAI”预设,则无法与该服务通信。寻找“custom”、“OpenAI-compatible”或“advanced”选项,以暴露 Base URL 字段。
你的第一次请求
从 curl 开始,因为它去除了你与 API 之间的所有层。将 YOUR_KEY 替换为你复制的密钥。
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
成功的响应是一个包含 choices 数组的 JSON 对象。文本位于 choices[0].message.content,usage 块报告你被计费的 token。
使用官方 Python 库的相同调用如下所示。只有 base_url 和 api_key 与标准 OpenAI 设置不同。
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
在 Node 中,使用相同的包:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
你不需要设置 max_tokens。当省略时,补全可以使用提示词之后 100,000 token 窗口中的剩余部分。如果你希望限制每次调用的成本上限,请自行设置。
检查密钥是否有效且不消耗 token
在将密钥接入更大系统之前,向模型接口发起一次廉价调用。这将确认密钥被接受且 Base URL 正确。
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
-i 标志打印响应头部,该 API 在此报告有用的状态:
X-Request-Id标识请求。如果就特定调用联系 支持,请包含它。X-Balance-USD显示账户的剩余额度。X-RateLimit-Limit-Requests和X-RateLimit-Limit-Concurrency显示适用于你密钥的限制,让你一眼就能看出该密钥是试用限制还是完整限制。
在你的代码中读取 X-Balance-USD 是一种在额度耗尽前提醒自己的廉价方法。如果不想输出嘈杂,每个作业记录一次而不是每个请求记录一次。
使用密钥的成本
拥有密钥无需成本。你为 token 付费:每 1M 输入 token $0.15,每 1M 输出 token $0.50,从预付额度中扣除。失败或被拒绝的请求不收费。
上述转录清理调用的已运行示例。假设提示词为 1,000 token,清理后的回复为 500 token。
- 输入:1,000 / 1,000,000 x $0.15 = $0.00015
- 输出:500 / 1,000,000 x $0.50 = $0.00025
- 总计:每次调用 $0.0004
因此,$0.50 的试用额度大约可以覆盖 1,250 次该规模的调用($0.50 / $0.0004)。你的具体数字会有所不同,因为转录长度各异,但方法是相同的:计算输入的 token,计算输出的 token,然后相乘。
充值时,接受 $20 至 $500 之间的任意整笔金额。大额充值享有额外奖励:从 $50 起 +5%,从 $100 起 +10%,从 $200 起 +15%。例如,充值 $100 将为你获得 $110 的额度。你可以通过加密货币(TRC20 上的 USDT、Base 上的 USDC)进行支付。
保护密钥安全
API 密钥是你余额的密码。任何拥有它的人都可以花费你的额度,因此请这样对待它。
- 将其保留在源代码控制之外。从环境变量或密钥管理器中读取。
- 不要将其发布到浏览器 JavaScript 或移动应用包中。任何在用户设备上运行的代码都可能被检查。请在前端和 API 之间放置一个小服务器,由该服务器添加请求头。
- 不要将其粘贴到截图、工单或聊天消息中。
- 如果你认为密钥已泄露,请立即停止使用并联系支持团队,不要等待观察是否会发生问题。
隐私方面:发送到 API 的提示词不会用于训练。这是关于服务的声明,而不是让你发送你无需发送的机密信息的理由。如果任务不需要,请从转录内容中删除个人数据。
当调用失败时
大多数第一天的问题源于以下四种原因之一。
Base URL 错误
两个常见的错误是缺少 /v1 和重复的 /chat/completions。请逐字符将你的值与上表中的值进行比较。
密钥包含多余字符
从网页复制通常会带有尾随空格或换行符。请在代码中修剪该值,并检查标头内容是否为 Bearer,一个空格,然后是密钥。
模型名称不是 uncensored
客户端通常会默认使用其他模型名称。请在每次调用时显式设置模型。
HTTP 429
有两种情况,错误代码将它们区分开来。rate_limited 表示你每分钟发送的请求过多。concurrency 表示同时进行的请求过多。流式请求会占用并发限制名额,直到流结束,因此即使请求速率较低,读取速度慢也可能导致此错误。带有 Retry-After: 5 标头的 429 错误表示服务短暂过载;等待五秒后重试。在客户端中使用简短的指数退避即可处理所有三种情况。
有关完整参数列表、流式输出格式和函数调用详情,请参阅 API 文档。
更多指南
问答
这与 OpenAI 密钥相同吗?
不。它遵循相同的请求格式,因此 OpenAI SDK 可以与之配合使用,但它由本服务签发,仅适用于本服务的基础 URL。
获取密钥需要信用卡吗?
不。使用 Google 或电子邮件注册,然后在密钥页面一键领取 $0.50 试用额度。该试用无需卡片,有效期为 7 天。
我应该使用哪个模型名称?
在模型字段中使用 uncensored。调用 GET /v1/models 将列出该密钥可以访问的内容。
我可以在多个服务器上使用同一个密钥吗?
是的,但限制适用于整个密钥:完整密钥为 8 个并发请求和每分钟 300 个请求,试用密钥为 2 个并发请求和每分钟 60 个请求。
该密钥适用于图像或语音吗?
不。该 API 仅支持文本。它不生成或转录音频或图像,也没有嵌入或微调功能。