接入地址与鉴权
Fluxlane API 的服务地址、各接口路径,以及 Bearer 与 x-api-key 两种鉴权方式、请求格式和请求 ID 的使用方法。
接入地址
| 项目 | 值 |
|---|---|
| 服务根地址 | https://run.fluxlane.ai |
| OpenAI 兼容 Base URL | https://run.fluxlane.ai/v1 |
| 请求格式 | Content-Type: application/json |
接口路径一览见平台介绍与接入方式,SDK 的地址写法见地址写法。
鉴权方式
所有接口都使用 API Key 鉴权。
| 接口 | 请求头 |
|---|---|
| 所有接口(推荐) | Authorization: Bearer sk-你的令牌 |
POST /v1/messages(Anthropic SDK 默认方式) | x-api-key: sk-你的令牌,并带上 anthropic-version: 2023-06-01 |
/v1/messages 两种方式任选其一;其他接口使用 Authorization: Bearer。
export FLUXLANE_API_KEY="sk-你的令牌"
curl https://run.fluxlane.ai/v1/models \
-H "Authorization: Bearer $FLUXLANE_API_KEY"
OpenAI 兼容 SDK 一般只需设置 base_url 与 api_key,SDK 会自动带上鉴权请求头,示例见 SDK 示例。
请求 ID
网关在响应头 X-Oneapi-Request-Id 中返回请求 ID。排查问题或联系支持时请附上它,可以快速定位到具体请求。用 curl 时加 -i 即可看到响应头:
curl -i https://run.fluxlane.ai/v1/models \
-H "Authorization: Bearer $FLUXLANE_API_KEY"
密钥安全
- 每个应用使用独立的 API Key,生产环境启用 IP 白名单。
- 通过环境变量或密钥管理服务保存 Key,禁止写入前端代码和公开仓库。
- 发现异常调用时立即禁用对应密钥,并在控制台「使用日志」中检查调用记录。
鉴权失败的排查步骤见鉴权、余额与权限问题。