如何将 Agnes AI 接入 Hermes Agent

Agnes AI 完全兼容 OpenAI API 格式，配置非常简便。以下是接入步骤。

1. 注册账号

访问 platform.agnes-ai.com 注册，邮箱验证即可开通，无需绑定支付方式。

2. 获取 API Key

登录后在 Settings → API Keys 创建 Key，复制保存。

3. 配置 Hermes Agent

# 添加 provider
hermes auth add custom:agnes --type api-key 
  --api-key "你的API_KEY" 
  --inference-url https://apihub.agnes-ai.com/v1
可选：设为默认 provider
hermes config set default_provider custom:agnes
hermes config set providers.custom:agnes.model agnes-2.0-flash

4. 验证

curl https://apihub.agnes-ai.com/v1/chat/completions 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer 你的API_KEY" 
  -d '{
    "model": "agnes-2.0-flash",
    "messages": [{"role":"user","content":"你好"}]
  }'

返回 200 即成功。

5. 调用图片 / 视频模型

图片生成（OpenAI 兼容格式）：

curl https://apihub.agnes-ai.com/v1/images/generations 
  -H "Authorization: Bearer 你的API_KEY" 
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "a cute cat, digital art",
    "n": 1,
    "size": "1024x1024"
  }'

视频生成为异步任务：

curl https://apihub.agnes-ai.com/v1/video/generations 
  -H "Authorization: Bearer 你的API_KEY" 
  -d '{
    "model": "agnes-video-v2.0",
    "prompt": "A cat walking, 5 seconds"
  }'
返回 task_id，轮询获取结果

注意事项

• 当前免费使用，但建议关注官方公告了解后续定价变化
• 视频生成为异步任务，提交后返回 task_id，需要轮询完成状态
• 国内网络可直接访问，无需代理
• OpenAI 兼容性好，绝大多数 SDK 可直接替换 base_url