API 文档：快速入门指南

基础 URL 和认证

Heretic AI API 完全兼容 OpenAI。您可以通过将客户端指向我们的基础 URL 与其交互： https://api.hereticai.cc/v1. 身份验证使用每个账户唯一的 API 密钥，该密钥在通过 Google 或电子邮件注册时即时生成。将此密钥传递到 Authorization 页眉作为 Bearer 令牌。模型标识符仅为 uncensored. 单一模型处理您的所有请求，无路由复杂性。401 错误表示密钥无效，402 错误表示您需要更多预付费加密余额。

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

聊天完成端点

使用 POST /v1/chat/completions 端点。API 期望一个包含您对话历史或提示的标准 messages 数组。它在 choices 数组。这是一个纯实用 API：文本输入，文本输出。你仅按消耗的令牌付费。预存信用额度永不过期，拒绝或错误不会消耗令牌。这种方法消除了订阅锁定和不可预测的免费层级。

Copyfrom openai import OpenAI

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

流式响应（SSE）

通过将 stream: true 在您的请求中。API 为每个生成的 Token 返回服务器发送的事件 (SSE)。这允许您渐进式显示输出，这对于延迟敏感型应用程序至关重要。Token 用量统计出现在流的最后一个数据块中。此功能与自动处理 SSE 的标准 OpenAI SDK 无缝协作。它提供即时反馈，无需等待完整完成。

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 支持带有 tools 和 tool_choice 参数。在请求中定义您的工具模式，模型将在适当时返回结构化的函数调用。这启用了 LLM 决定下一步采取哪种操作的复杂工作流。您可以强制使用特定工具，也可以让模型自由选择。这种功能对于构建与外部系统或数据库交互的代理应用至关重要。

JSON 模式

确保通过设置实现确定性输出 response_format 到 {"type": "json_object"}模型将限制其响应为有效的 JSON，这对于程序化解析至关重要。这减少了对后处理正则表达式修复的需求。它保证输出可直接被你的代码消费。这对于结构化数据提取或配置生成任务特别有用。

参数和限制

使用 temperature 等标准参数进行生成。 temperature, top_p，以及 seed. 上下文窗口为 100,000 token，包括提示和补全。每次请求的最大输出为 16,000 token，或者如果 max_tokens 未设置。速率限制为每分钟 300 次请求，每个密钥 8 个并发请求。请求体必须保持在 8 MB 以下。这些限制确保开发人员能够稳定地进行高容量使用。

Node.js

Copyimport OpenAI from "openai";

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