跳到主要内容

OpenAI SDK

把任意 OpenAI SDK 指向 Hermes 的 base URL,用你的 Hermes API 密钥调用 LLM。

设置 base URL 和密钥

对话接口兼容 OpenAI,官方 OpenAI SDK 无需改动即可使用。创建 API 密钥,导出为 HERMES_API_KEY,然后用以下 base URL 创建客户端: https://api.hermes-ai.net/api/v1.

shell
npm install openai
# or
pip install openai

export HERMES_API_KEY=your_api_key

创建 API Key

发送对话补全请求

流式输出、function 工具、JSON 模式和推理设置均原样透传。

curl https://api.hermes-ai.net/api/v1/chat/completions \
  -H "Authorization: Bearer $HERMES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4.5",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}],
    "max_tokens": 200
  }'

选择模型 ID

GET /api/v1/chat/models 列出可调用的 LLM 及其价格(美元 / 100 万 token)。把列表中的 id 作为 model 传入。GET /api/v1/models 是图像、视频和音乐模型目录,不是对话模型列表。

shell
curl https://api.hermes-ai.net/api/v1/chat/models

浏览 LLM

计费与错误

每个请求先按预估的提示词加 max_tokens 预留额度,再按模型报告的实际用量扣费并释放其余部分。设置 max_tokens 可减少预留。 错误使用 OpenAI 的 error 对象,并附带文档中的 Hermes 错误码。

对话补全(LLM)错误码

图像、视频和音乐模型

这些模型通过 POST /api/v1/jobs 以异步任务运行,不经过 OpenAI SDK。 任务与结果