EasySub-API
    • API指南
    • 登录态与订阅调用示例
    • 订阅任务
      • 1-查询启用方案
      • 2-提交订阅任务
      • 3-查询订阅任务
    • 支付卡管理
      • 1-查询支付卡列表
      • 2-新增支付卡
      • 3-查询支付卡详情
      • 4-修改支付卡
      • 5-删除支付卡
      • 6-批量导入支付卡
      • 7-批量修改支付卡
      • 8-启用或停用支付卡
      • 9-批量删除支付卡
      • 10-查询支付卡使用记录
      • 11-查询支付卡导入模板

    登录态与订阅调用示例

    1. API 密钥与 token#

    请求头的 API 密钥标识调用账号;请求体的 token 是待订阅账号的登录态,两者分别填写。
    token 始终是 JSON 请求中的字符串。JSON 登录态先序列化为字符串,再作为 token 值提交。示例中的登录态、卡片、方案 ID 都是占位值,联调时替换为实际值。

    2. ChatGPT / OpenAI#

    所选方案的 provider=openai。支持完整 Session JSON,也支持包含 access token 和邮箱的 JSON 字符串。
    登录态示例:
    {"access_token":"OPENAI_ACCESS_TOKEN","email":"account@example.com"}
    也可提交完整 Session JSON;请使用有效登录态。

    platform 完整请求#

    {
      "plan_id": "plus-ph",
      "token": "{\"access_token\":\"OPENAI_ACCESS_TOKEN\",\"email\":\"account@example.com\"}",
      "idempotency_key": "client-order-20261010-0001",
      "payment_method": {
        "type": "platform"
      }
    }

    custom 完整请求#

    {
      "plan_id": "plus-ph",
      "token": "{\"access_token\":\"OPENAI_ACCESS_TOKEN\",\"email\":\"account@example.com\"}",
      "idempotency_key": "client-order-20261010-0002",
      "payment_method": {
        "type": "custom",
        "card_number": "4242424242424242",
        "card_expiry": "08/39",
        "card_cvc": "123"
      }
    }
    card_number 建议纯数字;card_expiry 固定 MM/YY;card_cvc 是 3~4 位数字字符串。

    3. Claude#

    所选方案的 provider=claude。token 直接填写原始 sessionKey 字符串。
    {
      "plan_id": "claude-pro",
      "token": "CLAUDE_SESSION_KEY",
      "idempotency_key": "client-claude-0001",
      "payment_method": {
        "type": "custom",
        "card_number": "4242424242424242",
        "card_expiry": "08/39",
        "card_cvc": "123"
      }
    }

    4. Grok#

    所选方案的 provider=grok。支持 grok.com 的原始 SSO 值、sso=TOKEN、包含 sso 的 Cookie Header 或 Cookie JSON 字符串。
    {
      "plan_id": "grok-pro",
      "token": "{\"sso\":\"GROK_SSO_TOKEN\"}",
      "idempotency_key": "client-grok-0001",
      "payment_method": {
        "type": "platform"
      }
    }
    Cookie JSON 还可使用:
    {"cookies":[{"name":"sso","value":"GROK_SSO_TOKEN","domain":".grok.com"}]}
    domain 提供时须为 grok.com 或 .grok.com。所需凭据是 sso;仅有 auth_token 或 sso-rw 的 Cookie 请重新获取所需登录态。

    5. 压缩登录态#

    也支持 zstd64: 格式:
    1.
    将原始登录态按 UTF-8 编码。
    2.
    使用 zstd 压缩。
    3.
    对压缩字节执行标准 Base64 编码。
    4.
    在结果前加 zstd64:,作为 token 字符串。
    {"token":"zstd64:<标准Base64编码的zstd压缩内容>"}
    ChatGPT 的压缩前内容为登录态 JSON,Claude 为原始 sessionKey,Grok 为 SSO 凭据。可直接提交原始格式,压缩格式为可选项。

    6. curl 示例#

    先查询方案:
    再使用查询结果中非空的 plan_id 提交:
    提交成功后按返回的 order_no 查询:

    7. Python 提交与轮询#

    示例使用 requests。先安装 pip install requests,设置环境变量 EASYSUB_BASE_URL、EASYSUB_API_KEY、EASYSUB_PLAN_ID、OPENAI_ACCESS_TOKEN 和 OPENAI_ACCOUNT_EMAIL。
    发生提交网络异常时,重用已保存的 payload 再次提交。新业务任务才生成新的 UUID。custom 场景将 payment_method 替换为 type、card_number、card_expiry、card_cvc 对象,其余提交流程相同。
    修改于 2026-10-10 15:18:15
    上一页
    API指南
    下一页
    1-查询启用方案
    Built with