平台介绍与接入方式
Fluxlane 为合法授权的上游模型服务提供统一入口、身份认证、额度计量和调用日志。本文说明接入三要素和各协议的地址写法。
平台提供什么
| 能力 | 说明 |
|---|---|
| 统一接口 | 用 OpenAI 兼容格式接入多家厂商的模型;Claude 模型同时支持 Anthropic Messages 格式 |
| 密钥隔离 | 每个 API Key 可单独设置配额、过期时间、模型限制和 IP 白名单 |
| 用量可视 | 在控制台查看每次调用的模型、Token、响应时间和扣费 |
接入三要素
调用任何接口都需要以下三项:
| 要素 | 取值 | 从哪里获取 |
|---|---|---|
| 接口地址 | OpenAI 兼容:https://run.fluxlane.ai/v1;Anthropic SDK:https://run.fluxlane.ai | 见下方「地址写法」 |
| API Key | sk- 开头的完整密钥 | 控制台 → API 密钥,见创建与管理 API Key |
| 模型名 | 完整的模型 ID,例如 glm-5.3 | 控制台「模型广场」或 GET /v1/models |
地址写法
不同 SDK 和工具对「接口地址」的理解不同,填错是最常见的接入问题。
| 使用方式 | 填写的地址 | 实际请求 |
|---|---|---|
OpenAI 官方 SDK 及兼容工具(base_url) | https://run.fluxlane.ai/v1 | SDK 自动拼接 /chat/completions、/responses 等 |
Anthropic 官方 SDK(base_url) | https://run.fluxlane.ai | SDK 自动拼接 /v1/messages |
| 直接发 HTTP 请求(curl 等) | 完整路径,例如 https://run.fluxlane.ai/v1/chat/completions | 原样请求 |
注意
SDK 的 base_url 只填到 /v1(或服务根地址),不要把 /chat/completions 等接口路径也写进去,否则会出现路径重复导致的 404。
支持的接口
| 接口 | 用途 | 说明文档 |
|---|---|---|
POST /v1/chat/completions | 文本对话、识图、工具调用 | Chat Completions |
POST /v1/responses | OpenAI Responses 格式;部分模型只支持这条路径 | Responses |
POST /v1/messages | Anthropic Messages 格式(Claude 模型) | Anthropic Messages |
GET /v1/models | 查询当前 API Key 可用的模型 | 模型列表 |
POST /v1/video/generations | Seedance 视频生成 | 视频生成:Seedance |
POST /v1/videos | Kling、Hailuo、Vidu 视频生成 | 视频生成:Kling、Hailuo、Vidu |
各厂商对每条路径的支持情况不同,详见协议兼容性与迁移说明。
使用规范
只允许使用平台已授权开放的模型。禁止违法、侵权、绕过上游限制或其他滥用行为。使用时还需遵守上游模型的服务条款,以及隐私、内容安全和当地监管要求。