API 快速入门与集成

基础 URL 和认证

Heretic 项目提供单一的托管文本生成端点。使用 https://api.hereticproject.com/v1 作为您的基础 URL。认证依赖于通过 Authorization 。在仪表板上通过 Google 或电子邮件登录创建您的密钥。系统为每个账户颁发一个活跃密钥；生成新密钥会立即使旧密钥失效。

您只需按实际消耗的令牌付费。错误和拒绝不扣除您的预存信用额。新账户获得 $0.50 试用信用额，有效期为 7 天。您使用 USDT (TRC20) 或 USDC (Base) 充值，金额在 $20 到 $500 之间。

/v1/chat/completions 端点

向标准聊天补全端点发送消息。模型ID为 uncensored它接受具有如 system, user, 或 assistant. 该模型不拒绝合法的成人、虚构或争议性话题。它是一个经过调整以提供直接回答的开源权重模型。

请求返回包含生成文本的 JSON 对象。上下文窗口支持提示词和补全内容的总和为 100,000 个令牌。除非您指定较低的 max_tokens 值。

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK 集成

使用带有自定义 base URL 的官方 OpenAI Python 库。设置 api_key 到您的 API 字符串。配置 base_url 指向 Heretic Project 服务器。这使您可以使用熟悉的方法，例如 chat.completions.create() 无需大幅修改现有代码结构。

通过 pip 安装库。将凭据直接传递给客户端初始化。库会自动处理序列化。这种方法适用于同步和异步工作流。确保优雅地处理潜在的网络错误。

Copyfrom openai import OpenAI

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

Node.js SDK 与 Python 版本工作方式相同。使用 API 密钥和正确的基础 URL 初始化客户端。您可以使用相同的方法签名发送 completion 请求。这确保了您不同技术栈之间的一致性。

异步处理响应。如果您使用流式传输方法，SDK 将流式传输数据。否则，它将返回完整的 JSON 响应。这种灵活性支持批处理和实时界面。将 API 密钥安全地保存在环境变量中。

Copyimport OpenAI from "openai";

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

流式响应（SSE）

通过将 stream: true 在你的请求中。服务器发送服务器发送事件 (SSE)。每个数据块包含部分文本更新。这降低了最终用户的感知延迟。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)

限制、错误和上下文

遵守速率限制以避免服务中断。您每密钥每分钟允许 300 次请求。并发限制为 8 个同时请求。请求体不能超过 8 MB。超过这些限制将返回 429 状态码。稍作等待后再重试。

认证失败将返回 401 错误。如果密钥无效或已过期，就会发生这种情况。402 错误表示预付费余额不足。退款错误通过支持页面处理。余额永远不会过期。模型拒绝涉及未成年人的内容。接受所有其他合法内容。