入门指南
淘宝下单指南
淘宝购买后如何通过兑换码为账户充值，快速开始调用 API。
本文档仅适用于在淘宝店铺下单购买的用户。若您是直接在官网注册充值的用户，可跳过本章节，直接前往 注册与登录 开始使用。
流程概览
淘宝下单后，您将收到一张兑换码，需要先注册官网账户，再进入钱包管理输入兑换码完成充值，整体流程如下：
- 淘宝下单 → 系统自动发货兑换码
- 注册官网账户 → 前往 api.zestai.pro 完成注册
- 钱包管理充值 → 进入钱包管理输入兑换码，余额即时到账
- 创建 API Key → 在控制台创建令牌，配置 Base URL 与 API Key 开始调用
第一步：获取您的兑换码
在淘宝完成付款后，系统将自动发货，您的兑换码会以消息卡片的形式发送到您的淘宝账号。
获取方式：
- 打开淘宝 App 或网页端，联系客服或查看订单消息。
- 在消息中可以看到一个虚拟商品已发货的卡片，点击去查看。
- 复制其中的兑换码字符串，稍后将在官网钱包管理中使用。
请妥善保管您的兑换码，兑换码一经使用即作废，切勿将其分享给他人。
第二步：注册官网账户
前往 api.zestai.pro 完成账号注册。
详细的注册流程请参阅 注册与登录 章节。
第三步：进入钱包管理，输入兑换码充值
登录账户后，进入钱包管理页面，在兑换码输入框中粘贴您在淘宝收到的兑换码，点击兑换即可，充值金额将即时到账。
兑换成功后，您可以刷新当前页面，可以看到充值成功后的余额。
第四步：创建 API Key 并开始调用
充值完成后，进入控制台的令牌管理页面创建一个新的 API Key，然后在任意支持自定义 API 地址的工具或 SDK 中，填入以下两项配置即可立即使用：
| 配置项 | 值 |
|---|---|
| Base URL | https://api.zestai.pro （部分工具后面需要添加 /v1，或者完整端点/v1/chat/completions，具体查看您的工具或 SDK 所需的 Base URL示例） |
| API Key | 您在控制台创建的 sk- 开头的令牌 |
我们的接口完全兼容 OpenAI 标准格式（
/v1/chat/completions），同时原生支持 Claude、Gemini 等协议，您无需修改任何代码逻辑，仅替换 Base URL 和 API Key 即可完成接入。
示例：使用 Python OpenAI SDK 调用
from openai import OpenAI
client = OpenAI(
api_key="sk-xxxxxxxxxxxxxxxx", # 替换为您在控制台创建的 API Key
base_url="https://api.zestai.pro/v1",
)
response = client.chat.completions.create(
model="gemini-3.1-pro-preview",
messages=[{"role": "user", "content": "你好！"}],
)
print(response.choices[0].message.content)
常见问题
Q：兑换码可以多次使用吗？
A：不可以。每张兑换码只能使用一次，兑换成功后即作废，对应金额会充值到您的账户钱包中。
Q：可以不注册账户直接使用兑换码吗？
A：不可以。兑换码需要在官网登录后，进入钱包管理页面进行兑换，因此必须先完成账户注册。
Q：兑换码充值后如何续费？
A：账户余额不足时，您可以在淘宝重新下单购买兑换码，也可以直接在钱包管理中通过支付宝、微信在线充值，无需再经过淘宝。
Q：API Key 泄露了怎么办？
A：请立即在控制台 令牌管理 中禁用或删除泄露的令牌，并创建新的 API Key 替换。