API 调用

认证

OpenAI 和 Anthropic 兼容接口推荐使用 Bearer Token：

Authorization: Bearer YOUR_API_KEY

Gemini 原生客户端也可使用 x-goog-api-key。不要把密钥放在浏览器前端、公开仓库或可下载的客户端包中。

常用接口

协议或用途	方法与路径
查询模型	GET /v1/models、GET /v1/models/{model}
OpenAI Responses	POST /v1/responses
Responses 输入 Token 预检	POST /v1/responses/input_tokens
Responses 上下文压缩	POST /v1/responses/compact
OpenAI Chat Completions	POST /v1/chat/completions
Anthropic Messages	POST /v1/messages
Anthropic Token 计数	POST /v1/messages/count_tokens
Embeddings	POST /v1/embeddings
图片生成	POST /v1/images/generations
图片编辑	POST /v1/images/edits
视频创建与查询	POST /v1/videos、GET /v1/videos/{request_id}
Grok Web / X 搜索	POST /v1/web_search、POST /v1/x_search
Grok 语音合成 / 识别	POST /v1/tts、POST /v1/stt
Grok 自定义语音	/v1/custom-voices 及其 {voice_id} 子路径
Grok Realtime	GET /v1/realtime（WebSocket）
Gemini 模型列表	GET /v1beta/models
Gemini 内容生成	POST /v1beta/models/{model}:generateContent
Gemini 流式生成	POST /v1beta/models/{model}:streamGenerateContent?alt=sse
Gemini 显式上下文缓存	/v1beta/cachedContents 及其 {cacheID} 子路径
TypeSafe System One	POST /v1/systemone
Seedance Ark 视频任务	POST /api/v3/contents/generations/tasks 及其 {task_id} 查询/删除路径

并非所有分组或模型都支持表中全部接口。管理员启用分组模型白名单后，模型列表和单模型查询只返回允许项，各网关入口也会在路由与调度前拒绝不在名单中的客户端模型；不能通过复合路由、WebSocket 后续轮次或媒体接口绕过。/v1/responses/input_tokens 与 /v1/responses/compact 仅在对应上游和账号能力可用时生效。视频、搜索、语音和 Realtime 还取决于分组平台、上游账号能力及管理员是否完成对应价格和功能配置；当前实现中的 Grok 搜索与语音路由只对 Grok 分组开放。请先查询模型，并根据客户端和模型选择对应协议。

复合分组可按模型把 Chat Completions、Responses、Anthropic Messages、Token 计数和部分媒体请求路由到不同平台。当前网关也支持把 Kimi、智谱、DeepSeek、MiniMax、OpenCode、Cline、Command Code 与 TypeSafe 账号接入兼容协议；具体能否使用 Chat Completions、Anthropic Messages、Responses 或 System One，取决于管理员为该账号选择的原生、自适应或模型匹配协议，其中 Kimi 与 DeepSeek 可按账号配置使用原生 Responses，OpenCode 区分 Zen/GO 账号类型。终端用户不应根据供应商名称猜测协议，仍应以 /v1/models、密钥分组和实际请求结果为准。

视频任务还可通过 /v1/videos/generations、/v1/videos/edits、/v1/videos/extensions 创建，并用对应的 {request_id} 状态或 content 子路径查询；Seedance Ark 原生任务另使用 /api/v3/contents/generations/tasks（兼容 /v3、/v1 与无版本前缀）创建并按任务 ID 查询或删除。异步媒体请求应保留创建接口返回的请求 ID，轮询到完成状态后再下载结果。

Gemini 显式缓存支持创建、列出、读取、延长和删除，但仅适用于非复合的 Gemini API-key 分组，并要求命中的 AI Studio、Agent Platform (Vertex) 或兼容上游账号支持，且当前密钥具备余额或订阅结算能力。缓存资源与创建它的 API Key、当前分组和上游账号绑定；管理员可调整缓存 TTL 与价格，未调整时使用系统内置上限和 Gemini 存储价格。模型没有可用缓存存储价格时，创建会被拒绝。

OpenAI SDK

地区限制

本站不向来自中国大陆的用户提供任何 OpenAI 相关服务。

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://sub.fastapi.cool/v1",
)

response = client.responses.create(
    model="MODEL_ID",
    input="Hello",
)
print(response.output_text)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FAST_API_KEY,
  baseURL: "https://sub.fastapi.cool/v1",
});

const response = await client.responses.create({
  model: "MODEL_ID",
  input: "Hello",
});
console.log(response.output_text);

Anthropic Messages

curl https://sub.fastapi.cool/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Gemini 原生接口

curl "https://sub.fastapi.cool/v1beta/models/MODEL_ID:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

流式输出与重试

支持流式输出的接口可设置 "stream": true，Gemini 使用 streamGenerateContent?alt=sse。客户端应设置合理的连接和读取超时；只对可安全重试的请求采用指数退避，并避免因重复提交产生重复计费。客户端主动断开会在记录中标记为 499，用于和上游 5xx 区分；不能据此认定请求一定没有产生上游用量。

OpenAI Responses 路径可使用 HTTP/SSE 或 WebSocket，具体由账号、客户端和管理员网关设置决定。客户端传入的 prompt_cache_key、Codex/Claude Code 会话标识、模型范围与工具参数会尽量在路由切换和故障转移时保持；不要依赖自行伪造的会话头跨用户共享粘性。请求 service_tier 时只使用接口支持的 auto、default、fast、priority、ultrafast、flex 或 scale；管理员策略可能过滤、改写或拒绝，实际结算层级可在使用记录中核对。

错误排查

状态码	常见含义
400	参数、模型或协议不正确
401	API Key 缺失、错误或已失效
403	分组、模型、IP 或权限限制
402	余额或订阅额度不足
429	速率、并发或上游配额限制
499	客户端在响应完成前主动断开
5xx	网关或上游暂时异常

具体原因以响应体和控制台使用记录为准。响应头或响应体提供请求 ID 时请一并保存；运营错误详情中的模型配置错误可能不计入渠道 SLA，因此“渠道状态正常”不代表任意模型名都有效。