API 参考
Chat Completions
POST https://api.flyrouter.ai/v1/chat/completions
OpenAI 兼容的对话补全接口，可以调用全部文本模型（Claude、GPT、Gemini、Grok、DeepSeek 等），请求和响应格式与 OpenAI 官方一致。
请求示例
终端
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": "system", "content": "你是一个简洁的助手。"},
{"role": "user", "content": "什么是向量数据库？"}
],
"max_tokens": 1024
}'请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model | string | 必填。模型 ID，见 模型列表 |
messages | array | 必填。对话消息，role 为 system、user、assistant 或 tool |
stream | boolean | 是否流式返回，见 流式输出 |
stream_options | object | 流式时设 {"include_usage": true}，最后一个分片返回用量 |
max_tokens / max_completion_tokens | integer | 最多生成的 token 数 |
temperature / top_p | number | 采样参数。部分新模型（如新款 Claude、推理模型）不支持，传入会被拒绝或忽略 |
stop | string / array | 遇到这些字符串时停止生成 |
tools / tool_choice | array / string | 工具调用 |
response_format | object | 结构化输出 |
reasoning_effort | string | GPT 推理深度：low、medium、high，见 深度思考 |
消息内容可以是字符串，也可以是内容块数组（文字、image_url 图片），见 图片理解。
响应
json
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1761800000,
"model": "gpt-6.1-sol",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "向量数据库是……" },
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 26,
"completion_tokens": 182,
"total_tokens": 208,
"prompt_tokens_details": { "cached_tokens": 0 }
}
}finish_reason 的常见取值：stop（正常结束）、length（达到 max_tokens 被截断）、tool_calls（模型请求调用工具）。
用 Chat Completions 调用 Claude
可以，但只适合简单对话。提示词缓存、深度思考等 Claude 专有能力在 OpenAI 格式下可能无法使用或效果打折，需要这些能力时请改用 Messages。
FlyRouter