跳到主要内容

快速开始

三分钟完成首次 API 调用，立即体验多模型聚合服务。

TopRouter 是一个聚合型 AI 模型平台，通过统一的 REST API 接口提供多种主流大模型服务。

同时我们完全兼容 OpenAI API 和 Anthopic API 标准。如果您之前通过 OpenAI 或者 Anthropic SDK 访问模型，那么让您无需修改现有代码即可无缝切换到 TopRouter。

详情参见 OpenAI SDK 使用指南 | Anthropic SDK 使用指南

核心优势​

  • 稳定可靠：生产级别的服务质量，确保业务连续性
  • 价格优势：相比其他服务商更具竞争力的定价策略
  • 多模型支持：支持 OpenAI & Claude 全系列模型，满足不同场景需求

准备工作​

开始之前，请确保您：

  • 具备基本的编程知识
  • 了解 REST API 的基本概念
  • 能够访问互联网以使用我们的服务

第一步：获取 API 密钥​

首先，访问 TopRouter 控制台 注册账户并获取您的 API 密钥。

提示

建议将 API 密钥设置为环境变量 TOPROUTER_API_KEY，避免在代码中硬编码敏感信息。

第二步：发起 API 调用​

您可以使用任何支持 HTTP 请求的编程语言来调用 TopRouter API。以下是常见语言的示例：

Python​

import requests
import json

response = requests.post(
  url="https://api.toprouter.ai/api/openai/v1/chat/completions",
  headers={
    "Authorization": "Bearer <TOPROUTER_API_KEY>",
    "Content-Type": "application/json"
  },
  data=json.dumps({
    "model": "<TOPROUTER_MODEL_ID>",  # 例如：gpt-5、claude-4-opus
    "messages": [
      {
        "role": "user",
        "content": "生命的意义是什么？"
      }
    ]
  })
)

print(response.json())

TypeScript​

fetch('https://api.toprouter.ai/api/openai/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <TOPROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: '<TOPROUTER_MODEL_ID>',
    messages: [
      {
        role: 'user',
        content: '生命的意义是什么？',
      },
    ],
  }),
})
  .then(res => res.json())
  .then(data => console.log(data));

Shell​

curl https://api.toprouter.ai/api/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOPROUTER_API_KEY" \
  -d '{
  "model": "<TOPROUTER_MODEL_ID>",
  "messages": [
    {
      "role": "user",
      "content": "生命的意义是什么？"
    }
  ]
}'
流式响应

TopRouter API 支持流式传输（Streaming），可实现实时响应输出。

下一步​

恭喜！您已经成功完成了首次 API 调用。接下来您可以：

如有任何问题，欢迎查看我们的常见问题或联系技术支持。