接入教程

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, 认证方式与业务接口相同。

选平台前不妨先看我们的中转平台选型指南, 以及与主流平台的价格对比。

注册即送首充翻倍

按量计费,OpenAI 兼容接口,3 分钟接入。