Heretic LLM：API 文档

基础 URL 与认证

要开始使用 Heretic LLM API，请将你的 OpenAI 兼容客户端指向我们的基础 URL：https://api.hereticllm.com/v1。API 使用标准的 Bearer token 认证。你可以在“获取 API 密钥”页面仅通过电子邮件和密码注册来生成 API 密钥。密钥在注册后立即显示，且可随时重新生成，这将使旧密钥失效。

设置 OPENAI_API_KEY 环境变量或在客户端配置中直接传递密钥。确保你的基础 URL 已更新为 Heretic 接口。此设置允许你使用官方 OpenAI SDK，只需更改基础 URL 和密钥即可，无需修改代码。

首次请求

向聊天补全接口发起首次请求。模型标识符为 uncensored。该开放权重模型经过调整，可在合法成人用途下无内容拒绝地回答问题，非常适合无审查的代码编写、创意写作或研究。上下文窗口支持最多 100,000 token，包含提示词和补全内容。

下面是一个基本的 cURL 示例，用于测试接口。请将 YOUR_API_KEY 替换为你的实际密钥。

响应将是一个标准的 OpenAI 格式对象，包含生成的文本。

Copycurl https://api.hereticllm.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 包将 API 集成到你的 Python 应用程序中。该库自动处理 JSON 序列化和流式输出。使用你的 API 密钥和正确的基础 URL 初始化客户端。然后，使用模型 ID uncensored 调用 chat.completions.create。

此方法可无缝适用于同步和异步工作流。模型对标准提示词、函数调用和流式参数做出响应，与其他 OpenAI 兼容接口一样。你可以传递系统提示词以引导模型行为，或使用用户消息进行直接交互。

Copyfrom openai import OpenAI

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

对于 JavaScript 和 TypeScript 项目，请使用 openai npm 包。使用 Heretic 基础 URL 和你的 API 密钥配置客户端。API 支持标准请求结构，包括工具定义和函数调用。

确保正确处理响应，特别是在使用 async/await 模式时。模型返回文本响应，可直接在你的应用程序逻辑中处理。此集成非常适合构建需要无审查 LLM 能力的聊天界面、自动化代理或数据处理管道。

Copyimport OpenAI from "openai";

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

流式响应

通过在 API 请求中启用流式输出来启用实时响应。将 stream 参数设置为 true。API 将返回服务器发送事件 (SSE) 流，包含生成的文本块。这降低了感知延迟，并为聊天应用提供更流畅的用户体验。

流中的每个块包含响应的一部分。增量处理这些块以实时更新你的 UI。流式功能完全兼容 OpenAI SDK，因此你可以使用标准的 stream 迭代器或事件监听器来高效处理数据。

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 次请求的速率限制，请求体大小限制为 8 MB。超出速率限制将返回 429 错误。认证错误返回 401 状态，表示 API 密钥无效或缺失。预付额度耗尽时，API 返回 402 错误，需要充值。

额度永不过期，你可以使用加密货币（USDT 或 USDC）从 $10 起充值，大额存款可获得额外额度。模型支持 100,000 token 的上下文窗口。确保你的提示词和补全内容在此限制内。有关定价和限制的更多详情，请访问定价页面。