接入教程
OpenAI API 中转接入教程:3 分钟用上 GPT-5
中转平台的价值在于不改一行业务代码:官方 SDK 的请求结构完全不变,只要把 base_url 换成中转地址、密钥换成平台签发的 sk- 密钥。本文以本站为例,走一遍从注册到第一次调用的完整流程。
第一步:注册并创建密钥
在 登录页 用邮箱注册后进入控制台,在「API 密钥」页创建一把密钥。 密钥只在创建时完整显示一次,请立即保存。计费启用时新密钥余额为 0,需要先在「充值与账单」完成首充(新客享首充翻倍)。
第二步:替换 base_url
Python 官方 SDK:
from openai import OpenAI
client = OpenAI(
base_url="https://你的域名/v1",
api_key="sk-你的密钥",
)JavaScript / TypeScript:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://你的域名/v1",
apiKey: "sk-你的密钥",
});更完整的可复制示例(含 cURL、图像生成、错误处理)见接入文档。
第三步:第一次对话调用
response = client.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)model 填 auto 会自动选择可用模型;也可以在模型市场查看全部模型与单价后指定。需要流式输出时加stream=True,SSE 分片格式与官方一致。
常见报错与处理
- 401 密钥无效:检查密钥是否复制完整、是否被停用;密钥只显示一次,丢失后删除重建即可。
- 429 insufficient_quota:余额不足,充值后自动恢复。建议在控制台设置低余额告警。
- 429 rate_limit_error:触发了按密钥的 RPM/TPM/并发限流,响应带 Retry-After 头, 按提示退避即可;有更高需求可联系客服调整配额。
- 502 upstream_error:上游瞬时抖动,用指数退避重试一次通常即可恢复。
查余额与用量
控制台的「调用日志」可以按天查看每次调用的 token 与费用;程序化查询用GET /v1/billing/balance 和 GET /v1/billing/usage, 认证方式与业务接口相同。