🚀 全新智能路由引擎已上线

AI 模型聚合网关

全球算力，一键接入

聚合全球 AI 算力资源，统一模型接入，智能路由，自动容灾，让每一次调用都稳定高效

获取 API Key → 查看文档
https://firstapi.top 📋

开放平台 — 不只是中转，更是智能网关

六大核心能力，让 API 调用更智能、更稳定、更省钱

🧭

智能最优路由

自动比价所有渠道，每次请求路由到最低价渠道，帮你省下每一分钱

🔄

自动故障转移

失败自动切换下一个可用渠道，单次请求内完成，用户无感知

🔗

多供应商聚合

一个 Key 访问数百个模型，GPT / Claude / Gemini 一键切换

⚖️

优先级负载均衡

按优先级和权重分配流量，高优渠道优先，低优渠道兜底

📌

会话粘性路由

同一对话自动路由到同一后端，保证上下文连贯性

🛡️

自愈基础设施

故障渠道自动禁用，恢复后自动启用，路由表实时自修复

0
可用模型
0
AI 品牌
0
服务可用性
0
平均响应

3 步开始使用

从注册到调用，最快 2 分钟

1

注册账号

邮箱注册，无需信用卡，即刻开通

2

充值额度

支持多种支付方式，按量计费

3

获取 Key

创建 API Key，兼容 OpenAI SDK，即插即用

API 调用示例

bash 
curl https://firstapi.top/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

主流工具无缝集成

兼容 OpenAI SDK，主流 AI 工具开箱即用

🤖

Claude Code

export ANTHROPIC_BASE_URL=https://firstapi.top
export ANTHROPIC_API_KEY=sk-your-key
claude
🖱️

Cursor

// Settings → Models → OpenAI API Key
API Key:  sk-your-key
Base URL: https://firstapi.top/v1
🐾

OpenClaw

// ~/.openclaw/config.yaml
models:
  - id: firstapi/gpt-4o
    baseUrl: https://firstapi.top/v1
    apiKey: sk-your-key
📦

Codex

export OPENAI_BASE_URL=https://firstapi.top/v1
export OPENAI_API_KEY=sk-your-key
codex

📚 文档中心

从注册到上线，你需要的一切都在这里。

🚀 快速开始 💬 Chat API 📐 Embeddings 🖼️ Images 🤖 Claude Code 🖱️ Cursor 🐾 OpenClaw 📦 Codex 💰 计费 📊 模型表 ⚠️ 错误码

🚀 快速开始

  1. 注册账号 — 访问 firstapi.top/register，填写邮箱和密码完成注册。
  2. 获取 API Key — 登录后进入控制台，点击「令牌」→「创建令牌」，复制生成的 sk-xxx 密钥。
  3. 发起第一次调用 — 使用下方 curl 命令测试，将 sk-your-api-key 替换为你的真实密钥。
bash
curl https://firstapi.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hi"}]}'

💬 Chat Completions

兼容 OpenAI Chat Completions API，支持流式和非流式响应。

POST /v1/chat/completions

参数类型说明
modelstring模型名称，如 gpt-4o、claude-sonnet-4 等
messagesarray消息数组，包含 role 和 content
streamboolean是否流式输出，默认 false
temperaturenumber采样温度 0-2，默认 1
max_tokensinteger最大输出 token 数

📐 Embeddings

文本向量化接口，兼容 OpenAI Embeddings API。

POST /v1/embeddings

参数类型说明
modelstring如 text-embedding-3-small
inputstring | array待向量化的文本或文本数组

🖼️ Images

图像生成接口，兼容 OpenAI Images API。

POST /v1/images/generations

参数类型说明
modelstring如 dall-e-3、gpt-image
promptstring图像描述文本
sizestring尺寸：1024x1024 / 1792x1024 / 1024x1792

🤖 Claude Code 配置

bash
export ANTHROPIC_BASE_URL=https://firstapi.top
export ANTHROPIC_API_KEY=sk-your-key
claude

设置环境变量后直接运行 claude 命令即可。支持 Claude Sonnet 4、Opus 4 等全系列模型。

🖱️ Cursor 配置

打开 Cursor → Settings → Models → OpenAI API Key，填入：

API Key: sk-your-key

Base URL: https://firstapi.top/v1

🐾 OpenClaw 配置

OpenClaw 支持通过配置文件接入 FirstAPI，以下是完整配置示例：

yaml
# 编辑 OpenClaw 配置文件
# 路径: ~/.openclaw/config.yaml

providers:
  firstpi:
    type: openai
    url: https://firstapi.top/v1
    apiKey: sk-your-key

agents:
  defaults:
    model:
      primary: firstpi/gpt-5.5
      fallback: firstpi/deepseek-v4-flash

# 可用模型示例（provider/model 格式）:
# firstpi/gpt-5.5          - OpenAI 最新旗舰
# firstpi/claude-opus-4-6  - Anthropic 旗舰推理
# firstpi/deepseek-v4-pro  - 深度求索最强
# firstpi/kimi-k2.6        - Kimi 长文本
# firstpi/doubao-seed-2.0-pro - 字节豆包

配置步骤：

  1. 打开终端，编辑配置文件：nano ~/.openclaw/config.yaml
  2. 在 providers 下添加 firstpi 配置块
  3. 将 sk-your-key 替换为你的 API 密钥
  4. 在 agents.defaults.model.primary 设置默认模型
  5. 保存后重启 OpenClaw：openclaw gateway restart

切换模型：在对话中使用 /model firstpi/模型名 即可实时切换。

📦 Codex 配置

bash
export OPENAI_BASE_URL=https://firstapi.top/v1
export OPENAI_API_KEY=sk-your-key
codex

💰 计费说明

按实际 Token 用量计费，不同模型费率不同。1 倍率 ≈ 0.4 元 / 万 tokens。

模型厂商倍率参考价格
MiniMax-M2.7MiniMax0.5x≈0.2元/万tokens
doubao-seed-2.0-lite字节跳动1x≈0.4元/万tokens
MiniMax-M2.7-highspeedMiniMax1x≈0.4元/万tokens
kimi-k2.5Kimi1x≈0.4元/万tokens
glm-4.7智谱1x≈0.4元/万tokens
step-3.5-flash阶跃星辰1x≈0.4元/万tokens
doubao-seed-2.0-code字节跳动2x≈0.8元/万tokens
doubao-seed-2.0-pro字节跳动2x≈0.8元/万tokens
deepseek-v3.2深度求索2x≈0.8元/万tokens
kimi-k2.6Kimi2x≈0.8元/万tokens
mimo-v2.5小米2x≈0.8元/万tokens
deepseek-v4-flash深度求索3x≈1.2元/万tokens
mimo-v2.5-pro小米4x≈1.6元/万tokens
mimo-v2-omni小米4x≈1.6元/万tokens
glm-5.1智谱4x≈1.6元/万tokens
claude-haiku-4-5-20251001Anthropic4x≈1.6元/万tokens
gpt-5.4OpenAI5x≈2元/万tokens
gpt-5.5OpenAI5x≈2元/万tokens
deepseek-v4-pro深度求索9x≈3.6元/万tokens
claude-sonnet-4-6Anthropic10x≈4元/万tokens
claude-opus-4-6Anthropic20x≈8元/万tokens
claude-opus-4-6-thinkingAnthropic20x≈8元/万tokens
claude-opus-4-7Anthropic20x≈8元/万tokens
gpt-image-2OpenAI按次≈0.05~0.1元/张
image-01MiniMax按次≈0.07元/张

📊 模型对照表

供应商模型名称类型特点
OpenAIgpt-5.5对话最新旗舰
OpenAIgpt-5.4 / gpt-5.4-mini对话高性能 / 轻量
OpenAIgpt-5 / gpt-5.1 / gpt-5.2对话通用系列
OpenAIgpt-5.3-codex / gpt-5.3-codex-spark代码代码专精
OpenAIgpt-image-2图像图片生成
Anthropicclaude-opus-4-7对话最新最强
Anthropicclaude-opus-4-6 / claude-opus-4-6-thinking对话旗舰 / 深度思考
Anthropicclaude-sonnet-4-6对话均衡之选
Anthropicclaude-haiku-4-5-20251001对话快速响应
Googlegemini-3.1-pro / gemini-3.1-pro-preview对话多模态
Googlegemini-3-flash对话极速
深度求索deepseek-v4-pro对话最强推理
深度求索deepseek-v4-flash / deepseek-v3.2对话快速 / 性价比
字节跳动doubao-seed-2.0-pro / doubao-seed-2.0-code对话/代码通用 / 代码
字节跳动doubao-seed-2.0-lite对话轻量快速
Kimikimi-k2.6 / kimi-k2.5对话长文本
Kimikimi-for-coding / K2.6-code-preview代码代码专精
小米mimo-v2.5-pro / mimo-v2-omni对话多模态旗舰
小米mimo-v2.5 / mimo-v2-pro对话通用
智谱glm-5.1 / glm-5 / glm-4.7对话旗舰 / 性价比
MiniMaxMiniMax-M2.7 / MiniMax-M2.7-highspeed对话超低价 / 极速
MiniMaximage-01 / image-01-live图像图片生成
阿里qwen3.6-plus / qwen3.5-plus / qwen3-coder-plus对话/代码通义系列
阶跃星辰step-3.5-flash对话快速

⚠️ 错误码说明

错误码含义解决方案
401认证失败检查 API Key 是否正确
402余额不足前往控制台充值
429请求过于频繁降低请求频率或升级套餐
500服务器内部错误稍后重试，如持续出现请联系支持
503上游服务不可用系统将自动切换渠道，请稍后重试