开发者文档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-4GPT-4OpenAI最强大的多模态模型¥0.18/1K tokens
gpt-4oGPT-4oOpenAI更快更便宜的 GPT-4¥0.09/1K tokens
claude-3-5-sonnetClaude 3.5 SonnetAnthropic编程能力出色¥0.16/1K tokens
claude-3-opusClaude 3 OpusAnthropic顶级推理能力¥0.75/1K tokens
gemini-proGemini ProGoogleGoogle 最强模型¥0.08/1K tokens
qwen-maxQwen-Max阿里云阿里通义千问旗舰版¥0.12/1K tokens
ernie-4ERNIE-4百度百度文心一言4.0¥0.12/1K tokens
glm-4GLM-4智谱AI智谱最新模型¥0.10/1K tokens
查看完整模型列表

API 参考

POST/v1/chat/completions

创建聊天完成请求,支持流式输出。

请求参数

modelstring必需模型 ID,如 gpt-4
messagesarray必需消息列表,包含 role 和 content
temperaturenumber采样温度,默认 0.7
max_tokensinteger最大生成 token 数
streamboolean是否流式输出
GET/v1/models

获取所有可用模型列表。

SDK

我们推荐使用官方 OpenAI SDK,只需修改 base_url 即可。以下是各语言的安装方式:

Python

pip install openai

Node.js

npm install openai

Go

go get github.com/sashabaranov/go-openai

Java

Maven/Gradle 依赖

错误处理

FlowRouter 使用标准的 HTTP 状态码和 JSON 错误格式。

400

请求参数错误

缺少必填参数或格式不正确

401

认证失败

API Key 无效或已过期

429

请求过于频繁

超出速率限制

500

服务器错误

模型服务暂时不可用

准备好开始了吗?

新用户注册即送 10 元体验金,立即开始构建 AI 应用