Flatkey REST API：端点、认证与请求格式

Flatkey API 是完全兼容 OpenAI API 规范的 REST API。所有请求都发送到 https://router.flatkey.ai/v1，所有端点、供应商和模型共用同一个基础 URL。认证方式是在 Authorization 请求头中传入 Bearer token。

基础 URL

https://router.flatkey.ai/v1

所有请求都必须将 Flatkey API 密钥作为 Bearer token 传入：

Authorization: Bearer sk-fk-your-api-key

请在控制台中生成 API 密钥。完整说明请参阅认证。

端点	方法	说明
`/v1/chat/completions`	POST	对话与文本生成（兼容 OpenAI）
`/v1/responses`	POST	OpenAI Responses API（有状态多轮对话）
`/v1/embeddings`	POST	文本嵌入
`/v1/images/generations`	POST	图片生成
`/v1/models`	GET	列出可用模型

由于 API 兼容 OpenAI，你可以直接使用官方 OpenAI Python 或 Node.js SDK，无需修改请求代码，只需设置 base_url：

from openai import OpenAI

client = OpenAI(
    api_key="sk-fk-your-api-key",
    base_url="https://router.flatkey.ai/v1",
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-fk-your-api-key",
  baseURL: "https://router.flatkey.ai/v1",
});

Flatkey 使用与 OpenAI API 相同的版本管理方案。/v1 路径前缀保持稳定。OpenAI 发布新 API 版本时，Flatkey 会在保持 /v1 向后兼容的同时增加支持。

速率限制按 API 密钥应用。超出限制时，你会收到 429 Too Many Requests 响应。如生产工作负载需要更高限制，请联系 support@flatkey.ai。

内容类型	用途
`application/json`	所有请求体和响应
`text/event-stream`	流式响应（`stream: true` 时）