AI 订阅与礼品卡批量采购：API / MCP 批发接入

AIBulk 没有单独的「批发商」身份，也没有审核环节：任何注册用户都可以一键生成 API Key，用余额批量采购 ChatGPT、Claude、Gemini、Grok、X Premium、Telegram Premium 兑换码以及美区 Apple、Roblox 礼品卡，再转售或内部分发。网页零售与 API 在同一等级下价格完全一致。

适合谁

  • 转售商 / 代充店铺：需要稳定货源、即时发码、可代客户完成激活。
  • 开发者 / SaaS：想在自己的产品里内嵌「购买 AI 会员」能力，按量采购、不囤库存。
  • AI Agent：通过 MCP 直接下单、查库存、充值，不需要人工点网页。

等级与价格

等级分 = 累计消费 + 当前余额，只升不降；每个商品在每个等级有固定单价，网页、REST API、MCP 三个渠道相同。

等级 等级分 价格
Lv1 $0 零售价
Lv2 ≥ $100 等级价
Lv3 ≥ $500 等级价
Lv4 ≥ $2,000 等级价
Lv5 ≥ $10,000 最优价

充值即可升级：先充 500 USDT，所有后续订单直接按 Lv3 计价。各商品在你当前等级的具体单价，登录后在商品页或 GET /wholesale/v1/products 查看。

接入方式

  • REST API：GET /wholesale/v1/products 查商品与你的单价和库存，GET …/availability?qty=N 实时确认可售数量，POST /wholesale/v1/orders 下单（余额支付同步返回码；也可生成支付链接由人付款），POST /wholesale/v1/topup 充值，GET /wholesale/v1/transactions 对账。完整接口文档 · OpenAPI · 给 Agent 的 llms.txt
  • MCP（Streamable HTTP）：一行命令接入 Claude Code、Cursor 等客户端，工具包括 list_products、check_availability、get_balance、create_topup、purchase_codes、get_order 等。配置示例见开发者页。
  • Webhook：order.delivered、topup.credited、redemption.fulfilled / failed 等事件 HMAC 签名推送，失败指数退避重试 10 次，轮询仍可作为兜底。
  • 代客兑换：POST /wholesale/v1/redemptions 用你自己的订单码替客户完成激活，redeemFields 告诉你每个商品要收集什么信息，客户无需访问任何第三方页面。

四步开始

  1. 注册并登录，在账户中心点「获取 API Key」（只显示一次，前缀 awk_）。
  2. 用 USDT / USDC 充值余额（充值单 15 分钟内付款；未付款自动过期）。
  3. 用测试商品 prod_api_order_test（真实扣 0.01 USDT，1 件）跑通下单、取码、幂等与 Webhook。
  4. 正式下单：每单带唯一 externalOrderId，重试时复用同一个 ID，绝不会重复扣款。

规则与保障

  • 单笔 1 到 1000 件；限流 300 次 / 分钟（按 Key）。
  • 下单对 externalOrderId 幂等，充值对 externalTopupId 幂等；传 expectedUnitPrice 可在价格变动时拒单而不是默默成交。
  • 通过 API 出的兑换码不设有效期；兑换失败可修正信息后重新提交，码不作废。
  • fulfillmentStatus=needs_attention 表示人工核对交付或退款，请保留原单、联系客服，不要重复下单。
  • 金额一律十进制字符串（如 "12.50"），币种 USDT / USDC；USDC 充值 1:1 计入 USDT 余额。
  • 付款钱包不得与受制裁实体有直接或间接往来，详见使用说明。

常见问题

有最低起批量或月费吗？ 没有。等级只看累计消费和余额，没有起批量、没有月费、没有审核。

库存怎么保证？ 商品页和 availability 接口实时反映可售数量；即时交付商品付款即发码，人工交付商品会标明。

可以用客户的名义激活吗？ 可以，代客兑换接口就是为此设计的；你只需要在下单前按 redeemFields 收集信息。

价格会变吗？ 单价可能随上游调整，所以下单时传 expectedUnitPrice，价格变化会返回 price_changed 而不是按新价成交。

联系

接入问题请带上失败响应里的 requestId 联系 Telegram @aibulk 或 X @aibulk_official。相关页面：开发者接入 · 完整接口文档 · 退款政策

最后更新 2026-10-09