Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
用普通 HTTP 调用 REST API，不需要 SDK。涵盖 Base URL、鉴权、可用端点和错误处理。
https://router.flatkey.ai
Flatkey 提供 OpenAI 兼容的 REST API。你只要有 HTTP 客户端，就不需要 SDK。这一页是从拿到密钥到发出第一个请求的最短路径。
Authorization: Bearer YOUR_FLATKEY_API_KEY
sk-fk- 开头。把它放进环境变量，不要提交到代码仓库，也不要写进浏览器端代码。
export FLATKEY_API_KEY="sk-fk-..."
curl --fail-with-body -sS https://router.flatkey.ai/v1/chat/completions \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [{ "role": "user", "content": "你好！" }]
}'
choices 和 usage。
| 端点 | 用途 |
|---|---|
POST /v1/chat/completions | 文本与对话生成 |
POST /v1/responses | Responses API，用于 OpenAI 系模型 |
POST /v1/images/generations | 图像生成与编辑 |
POST /v1/videos | 视频生成，异步 |
GET /v1/videos/{task_id} | 轮询视频任务 |
GET /v1/models | 列出可用模型 |
GET /v1/credits | 剩余余额 |
POST /v1/responses 目前支持 OpenAI 系模型。其他系列在这个端点上会报错，请改用 POST /v1/chat/completions。curl --fail-with-body -sS https://router.flatkey.ai/v1/credits \
-H "Authorization: Bearer $FLATKEY_API_KEY"
{ "remaining": 34.18, "used": 185.13 }
{ "error": { "message": "No available channel for model ..." } }
| 状态码 | 含义 | 怎么做 |
|---|---|---|
400 | 请求格式有误 | 看 message，它会指出问题字段 |
401 | 密钥无效 | 检查 Authorization 头和密钥内容 |
429 | 请求过于频繁 | 退避后重试 |
500、503 | 模型或线路不可用 | 换模型。重试同一个通常不会恢复 |