AI API 中转站

AI API 中转接入指南：OpenAI 兼容接口与模型路由

如果你正在评估 AI中转站，本指南说明如何配置 SDK、选择模型或供应商路由、核对计费单位，并在接入生产流量前验证接口行为。

快速接入

OpenAI 兼容快速接入

把 AITransX 设置为 SDK base_url，保持聊天补全请求格式，通过 model 参数切换不同模型。

Python

from openai import OpenAI

client = OpenAI(
    api_key="aitx-your-key",
    base_url="https://api.aitransx.com/v1",
)

response = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Hello"}],
)

为开发者 API 流量设计

一个接口

保留 OpenAI SDK 接入方式，通过 model 参数切换不同模型。

全球模型覆盖

同一个 API 表面同时覆盖海外模型和中国大模型路由。

用量可见

在控制台查看状态、延迟、用量、费用和 Request ID。

如何选择模型与供应商路由

先从模型目录复制当前可用的模型 ID。普通模型 ID 由网关选择已配置的候选路由；需要指定供应商时，使用目录列出的 provider@model。不要自行拼接供应商名称。

auto 使用当前配置的默认模型。需要复现结果、对比价格或固定能力时，应指定模型 ID，并核对供应商路由。支持同一种请求格式不代表所有上游都支持相同的参数或功能。

按调用类型核对成本

对话一般按输入、输出词元计费；语音按对应模型的字符费率计费；生图可能按图片、请求或词元计费，以当前价格页为准。试用余额仅适用于符合条件的模型，请先确认账户可用范围。

上线前验证与错误处理

用低成本请求验证密钥、模型 ID、返回格式及费用，再测试流式输出和业务需要的参数。
设置 Key 的用量和请求速率限制，在日志中核对 Request ID、供应商、状态、用量与费用。
收到 401 时检查密钥；402 时检查余额和模型权限；429 时减少并发并退避重试；503 时检查路由状态或更换模型。
超时并不意味着上游未执行。重试生图等有费用的请求前先检查结果，避免重复调用。

查看对话、生图与语音的完整请求示例，并通过服务状态核对当前网关情况。故障切换受上游和路由配置限制，不保证任意故障都能自动恢复。

数据会经过哪些系统

请求经 AITransX 转发到所选上游。网关日志记录运维元数据，供应商的数据处理规则仍适用；主动创建的分享链接会保存分享内容至到期或删除。详情见隐私政策。

常见问题

如何配置现有的 OpenAI SDK？

把 base_url 替换为文档展示的 API 地址，使用 AITransX API Key，并从模型目录复制可用模型 ID。先用小请求验证返回格式和费用。

AI API 中转站可以调用哪些模型？

请查看当前模型目录并核对账户权限。路由可覆盖 OpenAI、Claude、Gemini、DeepSeek、Qwen、Kimi、GLM 等供应商；试用余额仅限符合条件的模型。

兼容接口是否支持所有上游功能？

不一定。参数、模态和流式行为取决于所选模型与路由。请按照文档中的对话、生图或语音端点，逐项验证业务所需功能。

用一个 API Key 开始

注册账号，领取试用额度，用同一个 OpenAI 兼容接口测试国内外大模型路由。

获取试用 API Key 查看价格