单一接口下的提示词与脚本
获取你的无审查文本 API 密钥,并在几分钟内向 stableaudio 文本管道发送请求。使用 OpenAI 兼容的接口进行提示词工程、字幕生成或后处理,预付计费可预测。
基础 URL 与身份验证
使用基础 URL https://api.stableaudio.top/v1 和任何标准的 OpenAI 兼容客户端。在 Authorization 头中传递你的 API 密钥,格式为 Bearer YOUR_API_KEY。你可以在“获取 API 密钥”页面使用 Google 或电子邮件 + 密码即时生成密钥。每个账户支持一个活跃密钥;生成新密钥将替换旧密钥。该接口仅支持 POST /v1/chat/completions 和 GET /v1/models。此处不提供嵌入、图像、音频或视频生成。这是用于你音频管道的仅限文本的层。
发送第一个请求
发送标准的 chat completion 请求以生成文本。模型 ID 为 uncensored。这是一个开放权重模型,针对合法成人话题减少了内容审查。你可以调整 temperature 和 top_p 等参数。该模型具有 100,000-token 上下文窗口。你可以请求每个响应最多 32,000 个 token。定价透明:每 1M 输入 token 0.15 美元,每 1M 输出 token 0.50 美元。错误和拒绝不消耗额度。
curl https://api.stableaudio.top/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 集成
使用官方 OpenAI Python SDK 将 API 集成到你的 Python 脚本中。在客户端配置中设置 base_url 和 api_key。这允许你利用已使用 OpenAI 接口的现有代码库。客户端自动处理 JSON 序列化和响应解析。你可以流式输出响应或批量处理它们。此方法适用于提示词生成、脚本编写或从文本输入中提取结构化数据以用于你的音频工作流。
from openai import OpenAI
client = OpenAI(base_url="https://api.stableaudio.top/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 集成
使用 OpenAI Node SDK 将 API 集成到你的 Node.js 应用程序中。使用正确的基础 URL 和 API 密钥配置客户端。这确保了与标准 OpenAI 模式的兼容性。你可以发起同步或异步请求。用于 Web 钩子或后台作业中的实时文本处理。SDK 处理重试逻辑和响应解析。这对于构建需要可靠、无审查文本输出的配音脚本或字幕管道非常理想,且无需订阅费。
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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 返回 Server-Sent Events (SSE)。Token 使用信息包含在最后一个块中。这降低了长文本生成的感知延迟。用于实时字幕或交互式提示词优化。模型 ID 仍为 uncensored。流式输出不改变定价模型。你仍只为实际生成的 token 付费。流式输出期间的错误被优雅处理,不消耗额外额度。
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)
Token 限制与配额
该模型支持 100,000-token 上下文窗口。最大输出为每次请求 32,000 个 token,如果未设置 max_tokens 则为 2,048。每个密钥限制为每分钟 300 次请求。每个密钥的并发请求上限为 8 个。请求体不得超过 8 MB。如果超出速率限制,你将收到 429 错误。如果密钥无效,你将收到 401 错误。如果预付额度不足,你将收到 402 错误。错误和拒绝免费。额度永不失效。通过银行卡(Visa, Mastercard, Apple Pay, Google Pay)或加密货币(TRC20 上的 USDT,Base 上的 USDC)充值,金额从 20 美元到 500 美元。
API 技术参数
所有限制、功能与价格一览。
| 项目 | 说明 |
|---|---|
| 接口格式 | 兼容 OpenAI:任何 OpenAI SDK 或客户端只需更换 base URL 和密钥 |
| 模型 ID | uncensored |
| 接口 | POST /v1/chat/completions · GET /v1/models |
| 认证 | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.stableaudio.top/v1 |
| 采样参数 | temperature、top_p、stop、seed、presence_penalty、frequency_penalty |
| JSON 模式 | response_format: {"type": "json_object"} |
| 最大输出 | 不单独限制输出;提示+回复共 100,000 个 token 窗口内,max_tokens 可选 |
| 流式输出 | 支持 SSE,最后一块包含 token 用量 |
| 函数调用 | 支持 tools、tool_choice;回复包含 tool_calls(流式同样支持),结果以 role: tool 消息返回 |
| 上下文窗口 | 100,000 tokens(输入与输出合计) |
| 速率限制 | 每个密钥每分钟 300 次请求 |
| 响应头 | X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests、X-RateLimit-Limit-Concurrency |
| 请求大小 | 每次请求不超过 8 MB |
| 并发 | 每个密钥同时最多 8 个请求 |
| 计费 | 预付额度,按实际 token 用量扣费;错误和拒绝不收费 |
| 价格 | 输入 $0.15 / 百万 tokens · 输出 $0.50 / 百万 tokens |
| 赠送额度 | 满 $50 送 5%,满 $100 送 10%,满 $200 送 15% |
| 免费试用 | $0.50,有效期 7 天,无需银行卡 · 试用密钥:2 个并发请求,每分钟 60 次;首次充值后恢复完整限额(8 和 300) |
| 充值 | USDT(TRC20)或 USDC(Base),$20–$500 任意整数金额 |
| 额度有效期 | 付费额度永不过期,无订阅 |
| 内容政策 | 允许成人内容;涉及未成年人的性内容一律拒绝 |
| 密钥 | 每个账户一个有效密钥;生成新密钥后旧密钥失效 |
| 登录 | 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 的“无审查”是什么意思?
该模型不会拒绝合法的成人、虚构、安全研究或争议性话题。它经过调整,可在无内容审查的情况下回答。唯一的硬性限制是始终屏蔽涉及未成年人的色情内容。
计费如何处理?何时错误免费?
你只需为实际的 token 使用付费。错误和拒绝不消耗你的预付额度。额度通过银行卡(Visa, Mastercard, Apple Pay, Google Pay)或加密货币(TRC20 上的 USDT,Base 上的 USDC)充值且永不失效。你可以充值 20 美元至 500 美元。
我可以将其用于图像或音频生成吗?
不可以。这是一个仅限文本的 chat-completions API。它为你的音频管道提供文本层支持,例如提示词编写或字幕生成。它本身不生成图像、音频或视频。