开发者文档API 参考
FlowRouter API 文档
完全兼容 OpenAI API 格式,只需修改 base_url 即可接入 40+ 主流大模型
快速开始
FlowRouter 完全兼容 OpenAI API 格式。如果你已经在使用 OpenAI SDK,只需将 base_url 改为我们的地址, 即可无缝接入 GPT-4、Claude、Gemini 等 40+ 主流大模型。
1
获取 API Key
注册账号并创建 API Key
2
修改 Base URL
指向 api.flowrouter.cn
3
开始调用
像调用 OpenAI 一样使用
1FA8C]">"text-[#FF79C6]">import openai
1FA8C]">"text-[#FF79C6]">class=1FA8C]">"text-gray-500"># 配置 FlowRouter 客户端
client = openai.OpenAI(
base_url=1FA8C]">"https:79C6]1FA8C]">">class="text-gray-5001FA8C]">">//api.flowrouter.cn/v1",
api_key=1FA8C]">"your-api-key"
)
1FA8C]">"text-[#FF79C6]">class=1FA8C]">"text-gray-500"># 调用 GPT-4
response = client.chat.comp1FA8C]">"text-[#FF79C6]">letions.create(
model=1FA8C]">"gpt-4",
messages=[
{1FA8C]">"role": 1FA8C]">"user", 1FA8C]">"content": 1FA8C]">"你好!"}
]
)
print(response.choices[0].message.content)认证
所有 API 请求都需要在 Header 中携带 API Key。你可以在控制台创建和管理 API Key。
安全提示
请勿在客户端代码中暴露 API Key。建议在服务端调用 API,或通过环境变量管理密钥。
请求头格式
Authorization: Bearer <your-api-key>模型列表
FlowRouter 支持 40+ 主流大模型,以下是部分热门模型:
| 模型 ID | 名称 | 提供商 | 描述 | 价格 |
|---|---|---|---|---|
gpt-4 | GPT-4 | OpenAI | 最强大的多模态模型 | ¥0.18/1K tokens |
gpt-4o | GPT-4o | OpenAI | 更快更便宜的 GPT-4 | ¥0.09/1K tokens |
claude-3-5-sonnet | Claude 3.5 Sonnet | Anthropic | 编程能力出色 | ¥0.16/1K tokens |
claude-3-opus | Claude 3 Opus | Anthropic | 顶级推理能力 | ¥0.75/1K tokens |
gemini-pro | Gemini Pro | Google 最强模型 | ¥0.08/1K tokens | |
qwen-max | Qwen-Max | 阿里云 | 阿里通义千问旗舰版 | ¥0.12/1K tokens |
ernie-4 | ERNIE-4 | 百度 | 百度文心一言4.0 | ¥0.12/1K tokens |
glm-4 | GLM-4 | 智谱AI | 智谱最新模型 | ¥0.10/1K tokens |
查看完整模型列表
API 参考
POST
/v1/chat/completions创建聊天完成请求,支持流式输出。
请求参数
modelstring必需模型 ID,如 gpt-4messagesarray必需消息列表,包含 role 和 contenttemperaturenumber采样温度,默认 0.7max_tokensinteger最大生成 token 数streamboolean是否流式输出GET
/v1/models获取所有可用模型列表。
SDK
我们推荐使用官方 OpenAI SDK,只需修改 base_url 即可。以下是各语言的安装方式:
Python
pip install openaiNode.js
npm install openaiGo
go get github.com/sashabaranov/go-openaiJava
Maven/Gradle 依赖错误处理
FlowRouter 使用标准的 HTTP 状态码和 JSON 错误格式。
400
请求参数错误
缺少必填参数或格式不正确
401
认证失败
API Key 无效或已过期
429
请求过于频繁
超出速率限制
500
服务器错误
模型服务暂时不可用
准备好开始了吗?
新用户注册即送 10 元体验金,立即开始构建 AI 应用