快速开始：集成 AI 女友 API

基础 URL 和认证

我们的 API 遵循 OpenAI chat-completions 标准，使现有客户端的集成变得简单。你必须在每个请求的 Authorization 头中包含 API 密钥。所有接口的基础 URL 为 https://api.roleplayapi.com/v1。使用官方 SDK 时，将 base_url 配置指向此地址，并将你的密钥作为 api_key 提供。此设置确保你的请求直达我们的专用无审查接口，无需修改标准逻辑。

发送补全请求

通过向 /v1/chat/completions 发送 POST 请求来发起对话。模型标识符为 uncensored。你可以在 messages 数组中传递任意数量的消息以建立上下文或开始新的对话。响应包含模型的文本输出，你可以将其流式输出或解析为 JSON 对象。此接口处理角色驱动应用所需的文本输入、文本输出核心交互。

Copycurl https://api.roleplayapi.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 集成

使用官方 openai Python 库，以最小的样板代码与 API 交互。使用我们的基础 URL 和 API 密钥配置客户端。然后，使用 chat.completions.create 并传入 uncensored 模型 ID。这种方法利用了现有的类型提示和错误处理机制，让你专注于应用逻辑而非 HTTP 解析。响应对象直接提供生成的内容。

Copyfrom openai import OpenAI

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

对于 JavaScript 和 TypeScript 项目，OpenAI Node SDK 为 API 调用提供了简洁的接口。使用自定义 base URL 和密钥初始化客户端。使用 uncensored 模型调用 chat completions 接口。此方法非常适合需要高效管理异步请求的 Web 服务器或边缘函数。SDK 会自动处理 JSON 负载的序列化和反序列化。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.roleplayapi.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 将返回数据块流，而不是单个完整响应。这对于期望即时角色回复的聊天界面特别有用。你可以处理每个到达的数据块，逐步更新 UI。当模型完成 token 序列生成时，流结束。

Copystream = 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 个请求。如果超出此限制，API 将返回 429 状态码。身份验证失败会导致 401 错误，而预付额度不足会触发 402 错误。上下文窗口支持最多 100,000 个 token，用于合并的提示词和补全。如果需要查看可用模型，请发送 GET 请求到 /v1/models。确保你的请求体不超过 8 MB。