Hermes API：三行代码切换客户端

安装 OpenAI SDK

由于我们的接口兼容 OpenAI，您可以使用您已知的官方 SDK。这种方法让您无需重写应用程序逻辑即可从其他供应商切换。我们支持 Python 和 Node.js 环境中的标准 openai 包。

确保使用最新版本的 SDK，以保证与流式输出和函数调用功能的兼容性。客户端库会自动处理 JSON 序列化和 HTTP 传输，因此您可以专注于模型参数，而无需关注网络细节。

配置基础 URL 和密钥

认证通过 Authorization 请求头中的 Bearer token 处理。你可以通过在仪表板上使用电子邮件和密码注册来获取密钥。试用无需信用卡，你可以随时重新生成密钥以撤销访问权限。

将基础 URL 设置为我们专用的接口。这确保所有请求都发送到我们的无审查模型基础设施，而不是默认的 OpenAI 云。您可以在注册后立即在“获取 API 密钥”页面上找到 API 密钥。

发送第一个请求

发送标准的聊天完成请求以测试连接性。模型 ID 始终为 uncensored。该模型经过调整，可在合法成人用途中无内容拒绝地回答问题，非常适合创意写作、角色扮演或不受限制的研究。

• 使用 POST /v1/chat/completions 进行文本生成。
• 上下文窗口支持最多 100,000 个 token 的提示词加补全。
• 请求根据输入和输出 token 数量收费。

Copycurl https://api.hermesllmapi.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."}]
  }'

启用流式输出（SSE）

为了获得更好的用户体验，请启用流式输出以接收生成的 token。这降低了感知延迟，特别是对于较长的响应。服务器返回服务器发送事件（SSE），你的客户端可以实时解析这些事件。

在请求体中将 stream 参数设置为 true。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 支持函数调用，允许模型输出用于外部工具执行的结构化 JSON。在 tools 参数中定义您的函数，如果合适，模型将在响应中返回 tool_calls。

此功能完全符合 OpenAI 规范。您可以解析函数名称和参数，执行后端逻辑，并将结果反馈到对话中。它与标准的 OpenAI SDK 函数调用工作流程完全兼容。

Copyimport OpenAI from "openai";

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

查看可用模型

查询模型接口以验证连接性并查看可用选项。目前，我们提供一个专用的模型：uncensored。这种简单性避免了模型路由或通用基础设施的复杂性，确保可预测的行为。

您也可以使用此接口调试身份验证问题。如果请求失败，请检查 API 密钥的有效性和网络连接。响应将列出模型详细信息，包括上下文窗口大小和 token 限制。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hermesllmapi.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 对每个密钥强制执行每分钟 300 个请求的限制。如果超过此限制，您将收到 429 错误。我们还支持 8 MB 的请求体限制，用于复杂提示词或大上下文窗口。

常见错误包括 401（密钥无效）和 402（额度不足）。预付额度永不过期，你可以随时充值。大额购买会自动获得额度奖励：$50 及以上赠送 5%，$100 及以上赠送 10%。