开始使用 API 指南模型接入 API 参考

开始使用

密钥与鉴权

同一个本站密钥用于模型接口及可用的独立工具接口。

Authorization: Bearer

OpenAI 兼容协议、模型列表与独立 Search/Fetch 接口使用 Bearer 密钥。密钥继承所属用户、绑定分组、额度与访问限制。

curl http://localhost/v1/models \
  -H "Authorization: Bearer $API_KEY"

Anthropic 原生鉴权

/v1/messages 支持 x-api-key，搭配 anthropic-version: 2023-06-01。模型与分组还必须允许该协议入口。

curl http://localhost/v1/messages \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"Hello!"}],"max_tokens":1024}'

配置建议

将密钥保存在客户端的私有环境变量或安全配置中。401 通常表示密钥无效；403 需结合错误正文判断分组权限、余额或业务限制。不要把所有错误都当成密钥失效。