开发文档
快速开始
几分钟内完成接入:创建 API Key,设置环境变量,用你熟悉的语言发出第一个请求。
准备工作
注册并充值
在 FlyRouter 控制台 注册账户,到 充值 页面充值。所有模型按实际用量从余额扣费,没有月费。
创建 API Key
打开 API 密钥 页面,点击「创建密钥」。密钥以 sk- 开头,只在创建时完整显示一次,请立即保存。
写入环境变量
把密钥放进环境变量,下文所有示例都从这里读取,不要直接写进代码。
终端
export FLYROUTER_API_KEY="sk-..."发出第一个请求
下面用 OpenAI SDK 调用 gpt-6.1-sol。和调用 OpenAI 官方相比,唯一的区别是 Base URL 指向 https://api.flyrouter.ai/v1。
终端
curl https://api.flyrouter.ai/v1/chat/completions \
-H "Authorization: Bearer $FLYROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.1-sol",
"messages": [{"role": "user", "content": "用一句话介绍你自己"}]
}'返回结构与 OpenAI 官方完全一致,回复文本在 choices[0].message.content,本次用量在 usage 字段。
调用 Claude
调用 Claude 推荐使用 Anthropic 官方 SDK(原生 Messages 协议),提示词缓存、深度思考等能力都能完整使用。注意 Anthropic SDK 的 Base URL 不带 /v1。
claude.py
# pip install anthropic
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["FLYROUTER_API_KEY"],
base_url="https://api.flyrouter.ai",
)
msg = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)Base URL 带不带 /v1
OpenAI SDK 填 https://api.flyrouter.ai/v1(带 /v1);Anthropic SDK 和 Gemini SDK 填 https://api.flyrouter.ai(不带 /v1),SDK 会自己拼接路径。填错是 404 最常见的原因。