TTS API 快速入门指南
本快速入门指南展示了如何将我们的无审查聊天补全 API 集成到您的 TTS 管道中。使用兼容 OpenAI 的接口生成脚本、字幕和对话,无需内容审查。
https://api.ttsapihub.com/v1
Base URL 和身份验证
首先配置客户端以指向我们的 Base URL:https://api.ttsapihub.com/v1。我们的 API 完全兼容 OpenAI,因此您可以使用标准 SDK,只需更新 base_url 并提供您的 API 密钥。身份验证通过带有 Bearer 令牌的 Authorization 标头处理。您在获取 API 密钥页面注册时生成唯一的密钥。每个账户限制为一个活跃密钥,您可以随时重新生成。您的提示词不用于训练,且开始使用试用额度无需电话号码或信用卡。
使用聊天补全生成文本
发送标准的 POST /v1/chat/completions 请求以生成文本。要使用的模型 ID 为 uncensored。该模型是一个开放权重 LLM,经过调整以在无内容审查的情况下回答合法成人用途的问题,非常适合创意脚本或对话,因为企业过滤器可能会阻止您的内容。它不生成音频、图片或视频;它输出纯文本供您的 TTS 管道处理。您可以根据需要调整 temperature 和 max_tokens 等参数。API 支持函数调用以进行结构化数据提取,允许您为应用程序格式化响应。
curl https://api.ttsapihub.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK 集成
对于 Python 开发者,官方的 openai SDK 只需最少配置即可开箱即用。使用您的 Base URL 和 API 密钥初始化客户端,然后调用 chat.completions.create()。这种方法允许您利用现有的兼容 OpenAI 的客户端,同时受益于我们的无审查模型。响应包含生成的文本,您可以直接将其输入到语音合成引擎中。请记住这是一个纯文本 API,因此您需要单独在管道中处理音频生成。
from openai import OpenAI
client = OpenAI(base_url="https://api.ttsapihub.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node SDK 集成
Node.js 开发者可以使用 openai npm 包,配置方式与 Python 相同。将 baseURL 设置为我们的接口并提供您的 API 密钥。使用模型 ID uncensored 调用补全接口。此集成非常简单,允许您将我们的文本生成功能直接集成到现有的 Node.js TTS 服务中。API 以标准 JSON 响应,便于解析和处理生成的文本以满足应用程序需求。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ttsapihub.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
通过 SSE 流式响应
为了降低延迟,请在请求中设置 stream: true 以启用流式输出。API 返回包含增量文本块的服务器发送事件 (SSE)。这对于长内容生成特别有用,因为用户可以看到实时出现的文本。流式响应遵循标准的 OpenAI SSE 格式,因此您可以使用现有的流解析器。这种方法减少了感知等待时间,并允许您的应用程序在文本生成时显示文本,从而改善 TTS 管道的用户体验。
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
限制、错误和上下文窗口
您的 API 密钥限制为每分钟 300 次请求和 8 MB 的请求体。该模型支持 100,000 token 的上下文窗口,允许处理长脚本或文档。常见错误包括 401(密钥无效)、402(余额不足)和 429(速率限制)。如果达到速率限制,请实施指数退避。定价透明:每 1M 输入 token $0.25,每 1M 输出 token $1.00。额度为预付额度,永不过期,充值从 $10 起。新账户获得 7 天内有效的 $0.50 试用额度,无需信用卡。内容限制仅阻止涉及未成年人的色情内容;所有其他合法的成人、虚构或争议性主题均允许。
接口能力与限制
购买额度前,请先确认接口是否满足你的需求——以下是全部真实参数。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 模型 ID | uncensored |
| 认证 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.ttsapihub.com/v1 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| JSON 模式 | response_format: {"type": "json_object"} |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 并发 | 每个密钥同时最多 8 个请求 |
| 请求大小 | 每次请求不超过 8 MB |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10% |
| 价格 | 输入 $0.25 / 百万 tokens · 输出 $1.00 / 百万 tokens |
| 充值 | USDT(TRC20)或 USDC(Base),$10–$500 任意整数金额 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | Google 或邮箱 + 密码 |
错误代码
错误以 JSON 返回,type 字段固定;失败或被拒绝的请求不计费。
| 状态码 | 类型 | 含义 |
|---|---|---|
400 | bad_request | JSON 无效、消息为空、参数错误或超出上下文窗口 |
401 | missing_key · invalid_key · key_revoked | 缺少密钥、密钥错误或已被新密钥替换 |
402 | no_credit | 余额不足——充值后立即恢复 |
403 | content_blocked | 涉及未成年人的性内容——拒绝且不计费 |
404 | not_found | 未知接口 |
413 | request_too_large | 请求体超过 8 MB |
429 | rate_limited · concurrency | 超过每分钟 300 次或 8 个并发——稍后重试 |
503 | upstream_busy | 模型繁忙——几秒后重试 |
问答
此 API 会生成音频吗?
不会,这是一个纯文本 API。它生成文本脚本或对话,然后您将其发送到单独的 TTS 引擎进行音频生成。它不生成音频、图片或视频文件。
如何开始使用此 API?
在获取 API 密钥页面使用电子邮件和密码注册。您会立即收到 API 密钥和 7 天内有效的 $0.50 试用额度。无需信用卡或电话号码即可开始。
上下文窗口大小是多少?
该模型支持 100,000 token 的上下文窗口,包括输入提示词和输出补全。这允许处理长文档或在您的管道中维护广泛的对话历史。