快速开始

按照以下三个简单步骤，您可以在 2 分钟内开始使用 OneRoute：

创建账户：访问 app.oneroute.ai 免费注册，即可立即访问平台。
生成 API 密钥：在平台中导航至 API Keys 页面，一键创建您的第一个 API 密钥。
更新您的代码：将您现有代码中的 API 请求基础 URL 改为 https://gw.1route.ai/v1，API 密钥替换为您的 Requesty API Key，即可开始路由请求。

集成示例

SDK 集成

使用 OpenAI SDK（推荐）

这是最简单的开始方式，对现有 OpenAI SDK 代码的改动最小，近乎实现"直接替换"。

提示：仅需更改 base_url 和 api_key 即可将现有 OpenAI 应用快速接入 Requesty。

Python
TypeScript
REST API

from openai import OpenAI

client = OpenAI(
  base_url="https://gw.1route.ai/v1",
  api_key="<ONEROUTE_API_KEY>",
)

completion = client.chat.completions.create(
  extra_headers={
    "HTTP-Referer": "<YOUR_SITE_URL>", # Optional. Site URL for rankings on openrouter.ai.
    "X-Title": "<YOUR_SITE_NAME>", # Optional. Site title for rankings on openrouter.ai.
  },
  model="openai/gpt-5.2",
  messages=[
    {
      "role": "user",
      "content": "What is the meaning of life?"
    }
  ]
)

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

import OpenAI from 'openai';

const openai = new OpenAI({
  baseURL: 'https://gw.1route.ai/v1',
  apiKey: '<ONEROUTE_API_KEY>',
  defaultHeaders: {
    'HTTP-Referer': '<YOUR_SITE_URL>', // Optional. Site URL for rankings on openrouter.ai.
    'X-Title': '<YOUR_SITE_NAME>', // Optional. Site title for rankings on openrouter.ai.
  },
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: 'openai/gpt-5.2',
    messages: [
      {
        role: 'user',
        content: 'What is the meaning of life?',
      },
    ],
  });

  console.log(completion.choices[0].message);
}

main();

curl "https://gw.1route.ai/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "x-oneroute-api-key: YOUR_ONEROUTE_API_KEY" \
  -H "x-portkey-provider: YOUR_PROVIDER" \
  -d '{"model":"gpt-3.5-turbo","messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"Hello!"}]}'

注意：

在 model 参数中，需使用 供应商/模型名 的格式（如 openai/gpt-4o），OneRoute 会据此将请求路由到正确的服务。

后续步骤

完成快速集成后，您可以：

在 OneRoute 控制台探索所有可用的模型和供应商。
查看 Analytics（分析） 面板，了解初始的请求数据和成本分析。
根据业务需求，配置更高级的智能路由规则或缓存策略以进一步优化性能和成本。

集成示例​

SDK 集成​

使用 OpenAI SDK（推荐）​

后续步骤​

集成示例

SDK 集成

使用 OpenAI SDK（推荐）

后续步骤