GETTING STARTED

快速开始

只需准备 API Key、选择模型，并把兼容 OpenAI 的客户端指向九关地址，即可发起第一次请求。

准备工作

1. 获取你自己的 API Key
   密钥一般以平台提供的格式显示。不要把密钥发给陌生人，也不要写入网页前端代码。
2. 确认可用模型名称
   在客户端的模型列表中选择，或先请求 /models 查看当前可用模型。
3. 选择调用方式
   可以使用支持自定义 OpenAI 地址的客户端，也可以直接使用 curl、Python 或 JavaScript。

查看模型

在终端执行下面的命令。将 YOUR_API_KEY 换成自己的密钥：

curl https://api.jiuguan.app/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

第一次聊天请求

将 YOUR_MODEL 换成上一步返回的模型 ID：

curl https://api.jiuguan.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己。"}
    ]
  }'

密钥安全

• 不要把真实 Key 发在群聊、截图、公开仓库或教程评论中。
• 浏览器网页会向访问者暴露前端代码，不适合直接保存长期 Key。
• 怀疑泄露时，应立即在密钥提供方后台删除旧 Key 并创建新 Key。
• 九关地址只负责转发；上游 API 服务仍会处理你的请求内容。