SDK 接入指南

AiToken 提供与 OpenAI 完全兼容的 API。你几乎可以不修改业务代码,把任意 OpenAI SDK 的base_url 指向 AiToken 网关即可。

1. 配置 base_url

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_AITOKEN_KEY",
    base_url="https://gateway.aitoken.example/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

2. 获取 API Key

在控制台「API Key」创建密钥。前端专用 Key 默认只读且短期有效,适合浏览器 / App 直连; 服务端 Key 可配置月度额度、模型白名单与子密钥作用域。

3. 智能路由与多厂商

启用 auto_route /smart_switch 后,网关会在多个上游厂商之间按质量评分(延迟 P50/P99、成功率、单位成本)自动择优与故障转移,无需在客户端切换地址。

4. MCP 工具

平台通过控制台「MCP 服务目录」纳管已接入的 MCP server,并自动纳入独立的 MCP 上游池,按会话亲和 (Mcp-Session-Id)转发,实现有状态会话的稳定路由。你可以在控制台MCP 服务目录中查看当前已开通的 MCP 服务;如需接入自有 MCP server,请联系商务或在工单中申请。