API类商品使用说明

本文介绍在本站购买 API 类商品（如 API Key、接口额度等）后，如何正确配置与使用。请在使用前完整阅读，以免因配置错误导致调用失败。

一、什么是 API 类商品

API 类商品通常以一串密钥（API Key）的形式交付。发货后，您会在订单详情页看到形如 sk-xxxxxxxxxxxxxxxx 的字符串，这就是您的访问凭证。调用方（您的程序、客户端软件或第三方工具）在每次请求时携带该密钥，服务端据此识别身份并扣减对应额度。

提示：API Key 等同于账户密码，请妥善保管，不要发布到公开的代码仓库、群聊或截图中。因密钥泄露导致额度被他人消耗的，一般无法找回。

二、快速上手步骤

  1. 获取密钥：支付完成后，在「订单查询」页面输入订单号或联系方式，即可查看已发货的 API Key。建议立即复制保存到本地安全位置。
  2. 确认接口地址（base_url）：API 类商品通常需要将默认接口地址替换为商品页面标注的专用地址。请以商品详情页或发货备注中提供的地址为准。
  3. 配置客户端：在您使用的软件或代码中填入 API Key 与 base_url（详见下文示例）。
  4. 发起测试请求：先用最小请求验证连通性，确认返回正常后再正式接入业务。

三、base_url 配置示例

不同的客户端与开发语言配置方式略有差异，核心都是两项：API Key 与 base_url。以下为常见场景示例（示例中的地址请替换为商品页提供的实际地址）：

1. Python（openai 库）

from openai import OpenAI

client = OpenAI(
    api_key="您购买到的API Key",
    base_url="https://api.example.com/v1"
)

2. 环境变量方式

export OPENAI_API_KEY="您购买到的API Key"
export OPENAI_BASE_URL="https://api.example.com/v1"

3. 第三方客户端软件

在软件的「设置 → 模型服务 / 自定义接口」中，将「接口地址」或「API 代理地址」填写为商品页提供的 base_url，将「密钥」填写为您的 API Key，保存后即可使用。

注意：部分客户端要求 base_url 末尾带 /v1，部分则要求不带。如果调用报 404 或路径错误，请尝试增删 /v1 后缀再测试。

四、常见问题

  1. 返回 401 / Unauthorized：密钥填写有误。请检查是否完整复制（无多余空格、换行），以及是否误用了其他平台的密钥。
  2. 返回 429 / 额度不足：请求过于频繁或剩余额度已耗尽。可稍后重试，或前往商城续购额度。
  3. 连接超时：请检查本地网络环境，确认能正常访问商品页标注的接口地址；更换网络环境后再试。
  4. 模型不可用：不同商品支持的模型范围不同，请以商品详情页列出的可用模型为准，勿调用未包含的模型名称。

五、售后说明

API 类商品发货后即视为交付。如遇密钥无法使用、额度与商品描述不符等问题，请保留报错信息截图，并附上订单号，通过页面底部的联系方式（QQ / Telegram）联系客服，我们会尽快为您核实处理。请勿将密钥转借他人使用，多设备高频共用可能触发风控限制。

返回帮助中心 去逛逛商城