统一模型接入与用量管理 立即注册
蓝天

配置指南

3 分钟上手蓝天

创建 API 密钥,选择当前实例开放的模型,发送第一条请求。

获取 API Key

  1. 登录蓝天,进入 API 密钥。
  2. 创建密钥,选择已开放的分组并保存。
  3. 在 钱包 查看余额,在 模型中心 确认模型调用 ID。

在代码中调用 API

本机后端的 OpenAI 兼容基础地址为 http://localhost:18081/v1。远程部署时应替换为你部署的后端域名。

curl http://localhost:18081/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"你好"}]}'

将 YOUR_API_KEY 和 YOUR_MODEL_ID 替换为实际密钥和当前分组提供的模型。密钥不要写入浏览器公开代码或提交到代码仓库。

检查模型目录

curl http://localhost:18081/v1/models -H "Authorization: Bearer YOUR_API_KEY"

如果目录为空,需要管理员先在 sub2api 配置上游账户和分组。没有上游账户时,创建密钥并不会自动开通模型。

调用没有成功?

状态检查项目
401确认密钥有效,并使用 Bearer 认证。
400 / 404确认请求路径、JSON 格式和模型调用 ID。
429查看账户额度、并发限制和重试响应信息。
5xx检查上游账户状态,保留请求 ID 以便排查。

查看调用记录