API 手册

FastAIToken 是一个兼容 OpenAI API 格式的 AI 网关。你可以使用一套接口、一个 API Key，调用 OpenAI、Claude、Gemini、Grok、DeepSeek、Qwen 等主流模型。

核心接入地址

• Base URL：https://www.fastaitoken.com/v1
• 认证方式：Authorization: Bearer YOUR_API_KEY
• 请求格式：application/json

平台能力

OpenAI 兼容调用

如果你原来使用 OpenAI SDK，通常只需要替换 base_url 和 api_key：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.fastaitoken.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[{"role": "user", "content": "你好！"}]
)

print(response.choices[0].message.content)

切换模型时，通常只需要修改 model 字段。

支持能力

• 对话补全：/v1/chat/completions
• 模型列表：/v1/models
• 向量嵌入：/v1/embeddings [开发中...]
• 图像生成与编辑 [开发中...]
• 视频生成 [开发中...]
• 多模态输入 [开发中...]
• 流式输出（SSE）[开发中...]
• 常用 OpenAI 参数：temperature、top_p、max_tokens 等 [开发中...]

基础信息

项目	内容
官方网站	https://www.fastaitoken.com/
控制台	https://www.fastaitoken.com/
API Base URL	https://www.fastaitoken.com/v1
API Key 获取	令牌管理

API Key查询余额

若是没有你代码可以复制下方的内容，并且改造你所需要的格式：

• 位置1: {{baseUrl}}
• 位置2: {{apiKey}}

({
    request: {
      url: "位置1/v1/usage",
      method: "GET",
      headers: { "Authorization": "Bearer 位置2" }
    },
    extractor: function(response) {
      const remaining = response?.remaining ?? response?.quota?.remaining ?? response?.balance;
      const unit = response?.unit ?? response?.quota?.unit ?? "USD";
      return {
        isValid: response?.is_active ?? response?.isValid ?? true,
        remaining,
        unit
      };
    }
  })

认证方式

所有请求都需要在 Header 中携带 API Key：

Authorization: Bearer YOUR_API_KEY

同时建议携带：

Content-Type: application/json

对话补全示例

cURL

curl -X POST "https://www.fastaitoken.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {"role": "system", "content": "你是一个有用的 AI 助手。"},
      {"role": "user", "content": "请用一句话介绍 FastAIToken。"}
    ],
    "temperature": 0.7
  }'

JavaScript

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.FASTAITOKEN_API_KEY,
  baseURL: 'https://www.fastaitoken.com/v1'
})

const response = await client.chat.completions.create({
  model: 'gpt-4.1-mini',
  messages: [
    { role: 'user', content: '你好！' }
  ]
})

console.log(response.choices[0].message.content)

流式响应

在请求中设置 stream: true 即可开启 SSE 流式输出：

stream = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[{"role": "user", "content": "讲一个短故事"}],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content or ""
    print(content, end="", flush=True)

最后一行 data: [DONE] 表示流式响应结束。

错误处理

接口遵循 OpenAI 风格错误格式：

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

常见错误：

错误码	HTTP 状态码	说明
invalid_api_key	401	API Key 无效或未填写
insufficient_quota	429	账户余额不足
model_not_found	404	模型名称错误或当前分组不可用
invalid_request_error	400	请求参数不合法
rate_limit_exceeded	429	请求频率过高
server_error	500	服务端异常，可稍后重试

接入建议

• API Key 使用环境变量保存，不要写死在前端或公开仓库。
• 根据业务拆分多个令牌，方便统计不同项目的消耗。
• 对 429、500 等错误实现指数退避重试。
• 图片、视频任务耗时更长，客户端超时时间建议设置更宽松。
• 上线前先查看 价格说明，确认所用模型的计费方式。