跳转到内容

接入客户端

开始前,先完成第一次调用。客户端使用的是用户 API 密钥,不是供应商凭证,也不是管理 API 的集成密钥。

客户端地址或入口需要准备
OpenAI 兼容 SDK、IDE、CLIBase URL:http://localhost:8787/v1用户密钥、网关模型 ID、已启用的 Chat 或 Responses 请求入口
Anthropic 兼容客户端请求地址:http://localhost:8787/v1/messages对应的 Messages 请求入口;SDK 的 base URL 按其拼接规则配置
Gemini 原生客户端http://localhost:8787/v1beta/models/模型ID:generateContentGemini 请求入口及其原生请求体
MCP 客户端http://localhost:8787/mcp 或 /mcp/服务标识已启用的 MCP 服务,用户密钥或 OAuth 授权

上表地址均为本地示例;部署后换成自己的代理服务域名。不同客户端可能自动拼接 /v1,保存前检查最终请求路径,避免重复前缀。

客户端填写模型页中的网关模型 ID,实际供应商模型名由路由映射。需要指定分组时使用 模型ID:路由组,例如 your-model:free。可使用的协议取决于该分组已启用的请求入口。

GET /v1/models 使用用户密钥,默认只列 LLM。图片、识别、合成、向量分别使用 kind=image、kind=asr、kind=tts、kind=embedding;kind=all 查看全部类型。kind=audio 兼容返回 ASR 和 TTS。

Terminal window
curl -sS http://localhost:8787/v1/responses \
-H 'Authorization: Bearer sk-your-api-key' \
-H 'Content-Type: application/json' \
-d '{"model":"your-route-model","input":"Hello"}'

模型可在 Chat 中调用,不代表它已经配置 Responses、Messages 或 Gemini 入口。遇到协议或模型找不到时,先到路由核对入口,再到请求日志查看处理结果。

SDK 字段与更多样例见 客户端接入参考。