API 文档

基础 URL 和认证

通过指向我们的专用端点并传递您的唯一 API 密钥来连接您的应用。所有请求的基础 URL 为 https://api.apertusapp.com/v1. 在 获取 API 密钥 页面。将此密钥包含在 Authorization 每次请求时的请求头。

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

每个账户生成一个活跃密钥。如果您生成新密钥，旧密钥将立即失效。这确保了对访问的严格控制，无需订阅分层或闲置费用。

首次请求

向聊天补全端点发送第一个提示以接收原始的、无过滤的文本。使用模型 ID uncensored 访问我们针对合法成人和争议性话题进行调优的特定开源权重模型。

Copyfrom openai import OpenAI

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

API 接受标准参数，例如 temperature 和 top_p. 错误和拒绝不消耗 Token，因此您只为实际到达模型的 Token 付费。与收取路由开销费用的聚合器相比，这种方法使成本更加可预测。

Node SDK 集成

使用官方 Node SDK 高效处理 JSON 模式和函数调用。设置 response_format 到 {"type": "json_object"} 用于结构化输出或定义具有类似智能体行为的功能工具。

Copyimport OpenAI from "openai";

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

该模型支持带有 tool_choice 选项。您还可以设置一个 seed 用于确定性结果。这种灵活性使您能够在不离开 OpenAI 兼容生态系统的情况下构建复杂应用。

流式响应

使用服务器发送事件 (SSE) 实时流式传输令牌，以实现低延迟的用户体验。每个数据块包含生成的文本，最后一个数据块包含总令牌使用统计信息。

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 自动处理 SSE 协议，在您的端只需极少的代码。

上下文窗口和容量

该模型支持 100,000-token 的上下文窗口，包含输入和输出。你可以指定每个请求最多 16,000 tokens，或者如果你省略 max_tokens.

这个大窗口允许进行广泛的文档分析或长对话历史。但是，请保持请求体在 8 MB 以下。该模型不是 GPT 或 Llama；它是一个独特的无审查 AI 模型，针对你的特定用例进行了优化。

错误处理和限制

优雅地处理标准 HTTP 错误以维持健壮的应用程序流程。A 401 表示 API 密钥无效或缺失。A 402 表示您的预付费余额已耗尽。A 429 表示您已超过每分钟 300 次请求或 8 个并发请求的限制。

余额永不过期，因此您可以在间歇期暂停使用。像重复扣款之类的错误可通过支持页面修复。预付费余额仅按实际 Token 消耗收费，确保每个字节的价格透明。