Hermes api 文档：快速入门

安装和设置

Hermes API 兼容任何支持 OpenAI 格式的客户。你需要基础 URL 和 API 密钥。通过 Google 或电子邮件在“获取 API 密钥”页面创建账户。系统会立即显示你的密钥。不需要电话号码。你会获得 7 天的 $0.50 试用额度。之后仅通过加密货币充值。

• 基础 URL：HTTPS://api.apihermes.cc/v1
• Auth 标头：Authorization: Bearer YOUR_API_KEY
• 模型 ID：uncensored

安装你首选的 SDK 并设置基础 URL。该端点期望标准的聊天补全参数。保持你的密钥安全。如果你生成新密钥，一个密钥将替换前一个密钥。

基本聊天补全请求

基本请求发送消息并接收文本响应。模型 ID 为 uncensored。它处理合法的成人内容而无需拒绝。您按使用的令牌付费。错误和拒绝不收费。上下文窗口总共容纳 100,000 个令牌。

使用 system 消息和 user 消息构建您的请求。API 返回补全。您可以设置 max_tokens 来控制输出长度。默认输出限制为 2,048 个令牌。您可以将每次请求的限制提高到 16,000 个令牌。流式传输通过 SSE 工作。函数调用可用。支持 JSON 模式。

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

请求体限制为 8 MB。速率限制为每分钟 300 次请求。并发限制为同时 8 个请求。重试逻辑可优雅地处理服务器过载。

使用 SSE 的流式响应

流式传输在生成时交付 token。服务器发送服务器发送事件（SSE）。每个数据块包含部分文本。最后一个数据块包含 token 用量统计。这种方法降低了长响应的感知延迟。它非常适合聊天界面。你必须正确处理流。可能会发生断开连接。API 不保证流本身之外的交付顺序。

将 stream 参数设置为 true。解析数据行。连接内容。检查 finish_reason 以确认完成。uncensored 模型适用于任何 OpenAI 兼容的 SDK。配置客户端以处理 SSE。监控 token 计数。基础 URL 保持不变。认证方式相同。无需额外设置。

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 支持工具和 tool_choice。将其用于代理或自动化。

构建 tools 数组。包括名称、描述和参数。模型决定何时调用工具。您必须解析参数。执行函数。将输出传递给对话。模型继续。此循环重复直到最终答案。上下文窗口跟踪所有工具交互。跟踪令牌使用情况。工具输出会增加成本。在最后一个块中监控使用情况。

Copyfrom openai import OpenAI

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

无审查模型处理多样化的工具模式。它不会基于内容进行拒绝。这适用于角色扮演或技术任务。API 可靠。无错误。预付费系统确保公平。您控制流程。基础 URL 一致。认证简单。

JSON 模式与参数

JSON 模式强制模型输出有效的 JSON。将 response_format 设置为 json_object。这对于结构化数据很有用。模型避免 Markdown 包装。它返回原始 JSON。使用它进行解析。它提高了可靠性。上下文窗口仍然适用。您为 token 付费。Uncensored 模型尊重格式。它不会基于内容拒绝。

参数包括 temperature、top_p、stop、seed、presence_penalty 和 frequency_penalty。温度控制随机性。top_p 控制多样性。停止序列终止生成。种子确保可重复性。存在和频率惩罚调整令牌使用。设置这些参数以优化输出。API 支持所有标准参数。使用它们调整响应。基础 URL 保持不变。身份验证方式相同。

Copyimport OpenAI from "openai";

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

错误通过 HTTP 状态码处理。401 表示密钥无效。402 表示余额不足。429 表示达到速率限制。请在代码中处理这些情况。预付余额仅对完成的令牌扣费。这确保了公平性。您无需为部分输出付费。系统透明。uncensored 模型可靠。可用于任何合法任务。

错误处理和速率限制

API 返回标准 HTTP 状态码。401 表示 API 密钥无效。402 表示预付费额度不足。429 表示速率限制。限制为每分钟 300 次请求。并发请求为八个。请求体限制为 8 MB。优雅地处理这些错误。使用指数退避重试。无限制模型不拒绝合法内容。错误是免费的。您不为失败的请求付费。预付费额度是安全的，永不过期。对于重复收费，请使用支持页面。仅限加密货币。USDT 或 USDC。适用奖金。