三步调用大模型

1获取 API Key

• 登录后进入「账户设置」→「API 密钥」

• 点击「创建新密钥」并复制保存

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2准备请求信息

API 地址
https://api.jfdmx.cn/v1/chat/completions
API Key
sk-xxxxxxxx
模型名称
gpt-4o / deepseek-chat

3发送请求

bash
curl -X POST https://api.jfdmx.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'

使用 SDK（推荐）

支持所有 OpenAI 官方 SDK，只需修改 base_url

🐍 Python
python
from openai import OpenAI

client = OpenAI(
    api_key="sk-你的API密钥",
    base_url="https://api.jfdmx.cn/v1"
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)
📦 Node.js
javascript
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-你的API密钥',
  baseURL: 'https://api.jfdmx.cn/v1',
})

const resp = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(resp.choices[0].message.content)

JSON 配置方式（Hermes Agent）

适用于 Hermes Agent 等支持自定义模型配置的工具

方式一：编辑 config.yaml（推荐）

在 ~/.hermes/config.yaml 中添加自定义模型：

yaml
# ~/.hermes/config.yaml
model:
  default: gpt-4o
  provider: custom
  base_url: https://api.jfdmx.cn/v1
  api_key: sk-你的API密钥

# 或使用环境变量方式（推荐）
# 在 ~/.hermes/.env 中添加：
# CUSTOM_API_KEY=sk-你的API密钥
方式二：CLI 快速设置

使用 hermes model 命令交互式选择：

bash
# 交互式选择模型
hermes model

# 或直接设置
hermes config set model.default gpt-4o
hermes config set model.base_url https://api.jfdmx.cn/v1
hermes config set model.api_key sk-你的API密钥
方式三：环境变量（.env 文件）
bash
# ~/.hermes/.env
CUSTOM_API_KEY=sk-你的API密钥
CUSTOM_BASE_URL=https://api.jfdmx.cn/v1
重要提示
  • • base_url 必须以 /v1 结尾
  • • API Key 格式为 sk- 开头的 32 位字符串
  • • 模型名称区分大小写，需与平台一致
  • • 配置后需运行 /reset 或重启 Hermes
完整配置示例
json
{
  "model": {
    "default": "gpt-4o",
    "provider": "custom",
    "base_url": "https://api.jfdmx.cn/v1",
    "api_key": "sk-你的API密钥",
    "context_length": 128000
  },
  "agent": {
    "max_turns": 90,
    "tool_use_enforcement": "auto"
  }
}