API 参考

基础 URL 和认证

使用专用基地址处理所有请求。您的 API 密钥通过 Authorization 。

• 基础 URL： https://api.hereticuncensored.com/v1
• 模型 ID： uncensored

从仪表板检索您的密钥。它在创建后立即有效。

Copycurl https://api.hereticuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five features of the new release."}]
  }'

首次请求

发送一个简单的聊天补全以验证连接性。该模型在合法成人用途下不使用标准内容过滤器进行响应。

• 设置 model 到 uncensored.
• 包含你的 messages 数组。

检查响应中的 choices 包含您生成的文本。

Copyfrom openai import OpenAI

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

使用您的基础 URL 和密钥初始化客户端。这确保了与标准 OpenAI 库的兼容性。

• 安装官方 openai 包。
• 通过 baseURL 和 apiKey 初始化期间。

调用 chat.completions.create() 附带您的提示。响应结构镜像标准 API 格式。

Copyimport OpenAI from "openai";

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

流式响应

通过设置启用实时 token 交付 stream 到 true. 这降低了长输出时的感知延迟。

• 监听 delta 分块。
• 组合数据块以重建完整响应。

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 支持 100,000-token 上下文窗口。每个密钥每分钟最多可发送 300 次请求。

• 最大并发请求数：8
• 最大 token 数：16,000（默认 2,048）

超出限制会触发 429 错误。管理并发量以保持高负载工作负载的稳定吞吐量。

错误处理和代码

优雅地处理错误以保持应用程序的稳定性。常见代码包括：401 表示密钥无效，402 表示信用额度不足。

• 429 表示速率限制耗尽。
• 400 表示请求体格式错误。

已消耗的令牌不提供退款。定期检查余额以避免服务中断。