快速开始

RouteAPI 为 OpenAI 兼容、Claude Messages 和 Google Gemini API 提供统一的认证入口。本指南将带你从注册账号、创建令牌，到验证第一条请求，并根据实际场景选择合适的接入方式。

三步完成接入

注册账号。 访问 RouteAPI 控制台，使用邮箱或 Google 注册。登录后可在仪表盘查看余额、用量和账号状态。
创建令牌。 打开 令牌管理 → 创建密钥，填写易于识别的名称和过期时间，并按需设置额度、模型限制。
发送测试请求。 将新令牌设置为 ROUTEAPI_KEY，选择可用模型，然后运行下方 cURL 示例。

发起请求

OpenAI 兼容接口是最快的验证方式，使用许多现有客户端都支持的基础对话格式。

export ROUTEAPI_KEY="sk-your-routeapi-token"

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "user", "content": "你好，RouteAPI"}
    ]
  }'

响应中会包含助手消息和用量信息。如果 API 或客户端返回请求 ID，请保存它用于排查问题。如果当前令牌无法访问 gpt-5.5，请替换为 GET /v1/models 返回的模型 ID。

选择接入方式

直接调用 API 使用 cURL 或任意 HTTP 客户端，适合需要完全控制且不想增加依赖的场景。

OpenAI 兼容 SDK 保留现有 OpenAI SDK 代码，只替换 API Key 和 Base URL。

开发者工具为 Codex、Cursor、Claude Code、OpenCode、LangChain 或 LiteLLM 配置 RouteAPI。

Node.js 与 Python

RouteAPI 兼容官方 OpenAI SDK。请选择运行时，安装对应的 SDK，并将 Base URL 指向 RouteAPI：

# Node.js
bun add openai

# Python
pip install openai

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.ROUTEAPI_KEY,
  baseURL: 'https://api.routeapi.ai/v1',
});

const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: '用一句话介绍 RouteAPI' }],
});

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

查看完整的 Node.js、Python 和 OpenAI SDK 示例。

使用流式输出

将 stream 设置为 true，即可通过 Server-Sent Events（SSE）逐步接收模型输出。客户端应逐行读取 data: 事件，并在收到 data: [DONE] 后结束响应。

curl https://api.routeapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用三点说明 RouteAPI"}
    ]
  }'

流式输出和最终用量事件取决于所选模型。请参阅流式响应了解 SSE 处理和连接建立后的错误。

验证与排查

接入较大的业务系统前，建议使用同一个令牌同时验证模型列表和真实请求：

curl https://api.routeapi.ai/v1/models \
  -H "Authorization: Bearer $ROUTEAPI_KEY"

401 — 检查令牌和 Authorization 请求头。
402 — 检查账户余额或令牌额度。
429 — 降低请求频率并查看限流配置。
502/503 — 检查模型服务状态，尝试可用模型或限制重试次数。
模型不可用 — 确认模型 ID 拼写和所需能力。

遇到复杂问题时，参阅请求排查和常见错误。控制台使用日志会记录状态、耗时、Token、费用和错误详情。

下一步

API 概览了解协议入口、Base URL、请求头和能力边界。

模型与价格查看模型 ID、能力、可用性和当前价格。

路由与故障保护在生产环境前了解服务路径、模型映射和故障保护。

生产环境请将令牌保存在服务端、固定模型 ID、记录请求 ID，并针对计划使用的模型验证流式输出、工具调用、结构化输出和多模态输入。