Xtts 流水线快速入门

认证与基础 URL

首先导航到获取 API 密钥页面，并使用 Google 或电子邮件密码登录。你将立即获得唯一的 API 密钥。对所有请求使用基础 URL https://api.xtts.cc/v1。此 URL 与官方 OpenAI SDK 以及支持 OpenAI chat-completions 格式的任何客户端兼容。

将你的密钥包含在Authorization标头中作为 bearer token。你必须发送的模型标识符是uncensored。该开放权重模型托管在我们的服务器上，并经过调整，可在合法成人用途中无内容拒绝地回答问题，确保你的语音流水线获得所需的原始文本。

生成无审查文本

向/v1/chat/completions发送 POST 请求，包含你的系统提示词和用户提示词。API 返回包含生成文本的结构化 JSON。此接口专为语音克隆工作流中的提示词编写、脚本生成和后处理任务而设计。

请求体包括模型名称、你的消息历史以及可选参数（如 temperature 或 top_p）。你可以使用max_tokens参数控制输出长度。如果你未设置max_tokens，响应可能会持续到上下文窗口结束。

复制curl https://api.xtts.cc/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 交互。将base_url设置为我们的接口，并提供你的 API 密钥。这种方法允许你利用现有的代码结构，同时受益于我们的无审查模型的行为。

使用基础 URL 创建客户端实例，然后调用chat.completions.create。传入uncensored模型 ID 和你的消息。响应对象在content中包含生成的文本。此方法非常适合批处理脚本或将文本生成集成到更大的 Python 应用程序中。

复制from openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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 集成

对于 JavaScript 环境，请使用 OpenAI Node SDK。使用我们的基础 URL 和 API 密钥配置客户端。此设置使你能够在 Web 或服务器端应用程序中直接生成文本。

使用uncensored模型调用聊天完成接口。响应提供生成的文本，你可以将其传递给语音合成引擎。此集成适用于 Web 应用中的实时文本生成，或为语音克隆准备脚本的后端服务。

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.xtts.cc/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);

流式响应

通过在请求中将stream设置为 true 来启用流式输出。API 为每个生成的 token 返回服务器发送事件 (SSE)。此功能对于实时文本显示或渐进式语音合成准备非常有用。

每个事件块包含部分文本。最后一个块包含使用统计信息，如 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)

速率限制与参数

每个 API 密钥限制为每分钟 300 个请求和 8 个并发请求。请求体不得超过 8 MB。如果你发送了无效的密钥，你将收到 401 错误。如果你的预付额度已用完，你将收到 402 错误。超过速率限制将导致 429 错误。

上下文窗口总共支持 100,000 个 token，包括提示词和补全部分。没有单独的输出上限，如果你希望回复更短，可以指定较低的 max_tokens。错误和拒绝不会消耗你的预付额度。支持函数调用和 JSON 模式用于结构化数据提取。