中文 ▾
立即开始

Apertus ia API Documentation

通过单个 API 密钥和标准的 OpenAI 兼容端点,将您现有的工具连接到无审查的 ia。

1. Quickstart: Connect Your First Request

基础 URL 为 https://api.apertusia.com/v1。在 Authorization 请求头中传递你的 API 密钥。模型标识符为 uncensored。此配置适用于任何兼容 OpenAI 的客户端。

使用此 cURL 命令立即测试连通性。将 YOUR_API_KEY 替换为您的实际密钥。

curl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

身份验证错误返回 401。余额不足返回 402。速率限制返回 429。

2. 支持的参数:Temperature、Top P 和 Seed

通过 temperature 控制随机性,通过 top_p 控制多样性,通过 seed 确保可复现性。这些参数遵循标准的 OpenAI 约定。将 temperature 设置为 0.7 可获得平衡的输出,或设置为 1.0 以提高创造性。使用 top_p 将采样限制在最高的概率质量范围内。seed 参数可确保在调试时输出完全一致。

用于本地测试的 Python 代码示例:

from openai import OpenAI

client = OpenAI(base_url="https://api.apertusia.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)

3. 使用服务器发送事件进行流式响应

通过设置 stream: true 启用流式传输。API 通过服务器发送事件(SSE)返回数据块。每个数据块包含部分文本和 token 使用量数据。这降低了长响应时的感知延迟。处理 SSE 事件以实时更新您的 UI。

使用官方 SDK 的 Node.js 示例:

import OpenAI from "openai";

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

4. 函数调用和 JSON 模式配置

使用 response_format 并传入 {"type": "json_object"} 以获取严格的 JSON 输出。这可为程序化管道确保结构化数据。通过在请求体中提供 tools 数组来启用函数调用。模型将以预期格式返回工具调用。使用 tool_choice 强制特定行为。

5. 速率限制和请求大小约束

每个 API 密钥支持每分钟 300 次请求。每个密钥的并发请求限制为 8 次。最大请求体大小为 8 MB。上下文窗口总共容纳 100,000 个 token。每次请求的最大输出可达完整的 100,000-token 窗口。不设置 max_tokens 或将其设置为较高值,以避免截断。错误不会消耗额度。不退还费用,但账单错误可通过支持团队更正。

6. 身份验证与错误处理

通过仪表板生成您的密钥。使用 Google 登录或电子邮件。密钥会立即显示。将其包含在 Authorization: Bearer 头中。无效密钥返回 401。429 错误表示速率限制已耗尽。402 错误表示您的预付费额度已用完。使用 USDT 或 USDC 充值。额度永不过期。

流式输出

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)

Common queries

What is the uncensored ia model context window?

该模型支持 100,000 token 的上下文窗口。这包括 prompt 和 completion。没有单独的输出上限:响应可以使用窗口中剩余的所有空间。

How do I handle streaming responses in Python?

在请求中将 <code>stream</code> 参数设置为 <code>true</code>。遍历响应对象以处理每个数据块。使用官方 SDK 以自动解析 SSE。

What happens if I hit the rate limit?

API 返回 429 状态码。你可以稍作延迟后重试。每个密钥每分钟允许 300 次请求。如有需要,可通过生成额外的密钥来提高并发量。

立即获取您的密钥

注册,获取密钥,指向我们的端点。完成。