DEVELOPER RESOURCES

API 接入文档

先选择卡密类型,再按示例提交和查询。

当前:网页端 API。按点数结算,每个请求提交一个账号。

HTTP POSTJSON卡密直连
接口地址POSThttps://your-domain.com/openapi.php
01准备卡密

准备 cdkd 网页点数卡

02提交任务

每个账号使用独立 request_id

03获取结果

保存任务 ID,每 5 秒查询一次

所有操作使用同一地址,通过 action 区分。手机 CDK / CDK1 沿用每条扣 1 次;独立网页 cdkd 点数卡使用当前开放的套餐,详见网页订阅接口。两类卡密及任务分别处理。

GETTING STARTED

请求与鉴权

直接使用业务卡密认证,无需额外的 API Key。请求体采用 JSON,并设置 Content-Type: application/json。

选择一种方式传递卡密

推荐请求头 Authorization: Bearer <cdkey>;也支持 X-CDKey: <cdkey> 或请求体中的 cdkey。

同时提供时,优先级为 Authorization → X-CDKey → cdkey。高优先级凭证无效时会拒绝请求,不会尝试其他凭证。

请求头示例
Content-Type: application/json
Authorization: Bearer YOUR_CARD_KEY
  • 手机订阅卡创建 run_all;提链接卡创建 extract_link。网页 cdkd 点数卡选择 sub6、sub12 或 sub24,并提供 request_id。
  • 已用完的卡密仍可查询自己的余额和任务;是否允许取消以当前任务状态及卡密状态为准。
  • 建议在服务端使用 HTTPS 调用。当前接口没有开放浏览器跨域访问,请勿将卡密写入公开前端代码。
WEB SUBSCRIPTIONS

网页端 API

使用独立的 cdkd-… 卡密调用 /openapi.php。手机 CDK / CDK1 不能提交网页方案;网页点数卡不会创建手机任务。

方案task_type / plan_code费用
正在读取已开放服务…

提交前调用 get_balance,从 plans 读取已开放的方案、plan_code、plan_label、cost_points 和 configured。客户只选择已开放且已配置的方案,费用不要写死。后台关闭的方案,用户页和 API 都不接受新订单;已有订单的结算、退点和重排沿用提交时的价格。

方案关闭时,新订单和客户对失败任务的重排返回 plan_disabled(409);原请求幂等重放、运行中或已成功任务更新资料继续允许。plan_price_not_configured 表示未设扣点,plan_not_configured 表示未设执行模板,请联系服务方。

上表只显示已配置 Worker 实际开启的套餐,未开启的不展示。卡密需先由管理员绑定专属 Worker,再调用 get_balance 读取该卡的套餐与价格。请使用返回的 plan_code,不要仅按月份判断业务。

提交时冻结对应点数,订阅成功后转为消耗;失败、取消或连接中断超时后退回。连接中断由服务端心跳超时检测处理。查询接口不会重新提交任务。

首次已有订阅的账号不接受开通

首次登录检查并按邮箱保存结果。已有订阅会停止开通并退点;用户明确重新提交这类失败任务时会重新检查。由本系统完成的订阅和续费阶段继续保留,不重复开通。

提交次数与重复提交规则

网页账号累计最多 10 次,跨卡计数,包含已删除记录,邮箱忽略大小写及首尾空格。达到上限请联系代理商。手机与网页分别计数。

同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。

action字段说明
get_balance / stats卡密鉴权返回 available_points 可用、reserved_points 冻结、spent_points 已消耗
submit_task / submitrequest_id、方案、email、password;twofa 与 recovery_email 至少一项每次提交一个账号;twofa 兼容 totp,支持 Base32 2FA 密钥或 Google 8 位备用码,不是 6 位动态验证码;有有效辅助邮箱时,2FA 可省略或留空
get_status / list / detail卡密鉴权;可选 task_id 或 email,不可同时填写;列表可用 limit / offset只查询本卡下的网页任务,建议每 5 秒一次;单条 data 为对象,按邮箱未匹配时为 null;不传筛选时为数组
cancel_task / canceltask_id只能取消仍为 queued 的任务,释放冻结点数;不会重复退款

推荐用 task_type 或 plan_code 指定方案;12月(US)必须使用 sub12_us,Ultra 使用 sub_ultra,不能只靠月数区分。原有 plan_months 请求继续兼容;同时填写时必须一致。未开放的方案不接受新订单。

2FA、备用码和辅助邮箱的填写格式

2FA 字段必须传字符串以保留前导 0。备用码 "00123456"、"0012 3456" 或 "bym-00123456" 均归一为 "bym-00123456";已有前缀不重复添加,前缀不区分大小写。Base32 密钥去空白并转大写。备用码按一次性备用码处理,不会作为 TOTP 密钥生成动态码;格式无效会返回 2FA 格式错误。

网页订阅的 2FA 与辅助邮箱至少填写一项。recovery_email 去首尾空白并转小写;缺省、空字符串 "" 或空白表示不填写,不影响原请求标识。有有效辅助邮箱时,twofa / totp 可省略或为空字符串;非空 2FA 仍须符合密钥或 8 位备用码格式。网页一键/批量导入兼容 邮箱----密码----2FA 三列、第三列直接填写辅助邮箱的 邮箱----密码----辅助邮箱 三列,也支持 邮箱----密码----辅助邮箱----2FA 四列;只填辅助邮箱的四列写法为 邮箱----密码----辅助邮箱----,空列保留分隔符。接口 account_data 同样接受这些格式,但每个网页请求仍只提交一个账号。辅助邮箱不出现在公开任务详情中;手机 CDK / CDK1 接口仍不支持辅助邮箱。

每个订单使用稳定的 request_id

首次提交前生成一个请求标识并保存。超时、断网或响应未确认时,用原内容和原 request_id 重试,服务端会返回原任务。不要为了重试生成新的 ID;同 ID 对应的账号或方案不能改变。

同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。

网页订阅 · 请求头 Authorization: Bearer cdkd-YOUR_CARD_KEY
{
  "action": "submit_task",
  "request_id": "9e6ca48c-37b2-4c51-b948-4a41ac0b626a",
  "task_type": "YOUR_ENABLED_PLAN_CODE",
  "email": "[email protected]",
  "password": "YOUR_ACCOUNT_PASSWORD",
  "recovery_email": "[email protected]",
  "twofa": "00123456"
}

网页任务状态

状态含义
queued排队中,可取消
dispatched / running已分配或执行中;API 只显示“处理环境”“登录中”“订阅中”
succeeded订阅成功,点数已消耗
failed失败;查看 status 和结算状态,不返回失败原因
cancelled已取消,点数退回
网页任务查询 · 使用原 cdkd 卡密鉴权
{
  "action": "get_status",
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}
查询响应示例(部分字段)· 失败已退款
{
  "success": true,
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]",
    "status": "failed",
    "settlement_status": "refunded",
    "initial_subscription_status": "preexisting",
    "message": ""
  }
}

列表默认 limit: 100,可设 1–1000;offset 默认为 0。网页状态为小写值,不使用手机任务的 Success / Failed / Running 映射。

网页任务无需结果链接。以任务状态和点数结算字段为准,不要用 HTTP 200 或是否返回链接判断订阅成功。

独立页面 · 网页卡密

反重力激活与订阅组合

用户页:反重力激活 ↗。使用网页 cdkd- 点数卡,可单独激活,也可先订阅再激活。原手机、普通网页订阅流程保留。

task_type服务冻结积分首次已有 Google AI Pro 订阅
正在读取已开放服务…

组合分开结算:订阅全部完成后扣订阅部分,保留原浏览器继续激活;激活成功再扣 1 点,激活失败只退这 1 点。首次已有订阅会跳过订阅、退订阅积分,继续激活,不关闭或删除原配置。普通订阅仍按原规则拒绝首次已有订阅。

操作请求说明
余额action=get_balance,网页卡密鉴权ag_activation.configured 表示激活模板是否开放。
提交action=submit_task,上表 task_type、request_id、email、password;twofa/totp 或 recovery_email 至少一项每请求一个账号,无需 plan_months。批量分别生成请求标识。
查询action=get_status,指定 task_id;列表加 task_type=ag_verify、limit/offset列表含该卡所有单独激活和订阅组合;也可用 sub6_ag/sub12_ag/sub24_ag 筛选。
POST /openapi.php · JSON 请求
{
  "action": "submit_task",
  "cdkey": "cdkd-YOUR_CARD_KEY",
  "task_type": "YOUR_ENABLED_SERVICE_CODE",
  "request_id": "ag-order-001",
  "email": "[email protected]",
  "password": "YOUR_ACCOUNT_PASSWORD",
  "twofa": "00123456",
  "recovery_email": ""
}
示例:订阅成功,激活失败;只退激活 1 点
{
  "task_type": "YOUR_ENABLED_SERVICE_CODE",
  "ag_requested": true,
  "status": "failed",
  "cost_points": 3,
  "subscription_cost_points": 2,
  "activation_cost_points": 1,
  "subscription_outcome": "completed",
  "activation_status": "failed",
  "charged_points": 2,
  "refunded_points": 1,
  "credential_available": true,
  "ag_verified": false,
  "credential": "YOUR_REFRESH_TOKEN",
  "export_line": "[email protected]_ACCOUNT_PASSWORD----无辅助邮箱----bym-00123456----YOUR_REFRESH_TOKEN"
}

subscription_outcome 为 pending/completed/skipped_existing;activation_status 为 not_started/pending/running/succeeded/failed/cancelled。charged_points、refunded_points 是订单各部分已扣/已退积分;激活重排仍保留已完成订阅的扣费,不累计历次失败退款。整体 failed 不表示全部退款,应分别显示订阅与激活结果。

凭证取得后即返回,后续失败也保留。credential_available:true 表示已取得凭证,ag_verified:true 才表示激活成功。导出格式固定为 账号----密码----辅助邮箱----2FA/备用码----凭证,缺失项保留字面值 无辅助邮箱、无2fa。将 export_line 原样复制,多条换行导出 TXT。普通手机及普通网页订阅不显示凭证导出。

同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。

AI 对接提示词:反重力与订阅组合
接入提示词
请按 https://pixel.geminixs.us/api-doc#ag-activation 接入独立反重力页面,保留原订阅页面。
POST /openapi.php,鉴权 cdkey,提交 submit_task,查询 get_status。
先确认余额接口 ag_activation.configured;单独激活使用 ag_activation.cost_points,组合仅使用文档当前开放且该卡 plans 中可用的订阅方案,订阅 cost_points 加激活 cost_points,不传plan_months。
已有订阅退订阅部分并继续激活;订阅成功后激活失败只退1点,不显示成全部退款。
保存每条请求的task_id/request_id,网络未确认时沿用原标识和参数。
列表task_type=ag_verify包含全部激活与组合任务,使用limit/offset分页,约5秒轮询。
分别显示subscription_outcome、activation_status和charged_points/refunded_points,激活重排保留已完成订阅的扣费。
credential_available和ag_verified分开显示;取得凭证即可复制与导出,失败不丢弃。
export_line原样导出,多条按换行连接;缺失值保持“无辅助邮箱”“无2fa”。
同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。
凭证导出只在包含激活的业务显示,按原卡鉴权。

网页端 · 错误对照

先判断请求是否成功,再判断任务是否完成。查询返回 HTTP 200 和 success:true,也可能查到失败任务。

请求被拒绝

success:false → 查看 error 和 message。参数或资格校验未通过时,不新建任务、不新增扣点;5xx 或网络超时需先查询确认。

任务执行失败

data.status:"failed" → 查看 data.status 和结算状态;失败原因不对外返回。

执行失败:客户提示与处理

下列失败任务结算为 refunded 时,点数已退回。以 settlement_status 为准,不要在接入程序中再退一次点。

以下分类供后台排查参考,客户 Open API 终态不返回原因字段。

error_code后台提示示例下一步
password_error密码错误核对密码,更新认证资料;不会自动重试。
twofa_error2FA / 备用码错误,或没有可用验证方式补充有效密钥、8 位备用码或辅助邮箱;不会自动重试。
captcha_no_sms人机验证需要手机验证人工处理账号验证后再联系服务方。
payment_error支付错误 / 支付货币不符检查支付资料,或联系服务方处理。明确的支付设置错误会停止重试。
no_offer无优惠账号不符合当前优惠条件,不自动重试。点数以实际结算状态为准。
initial_already_subscribed首次已有订阅,已停止后续操作此邮箱不再进入开通流程,请更换符合条件的账号。
initial_subscription_unconfirmed首次订阅状态未确认,已停止后续操作联系服务方检查页面或连接;未确认不会按“无订阅”继续。
disconnected连接中断刷新查询最终状态和点数;不要连续创建新订单。
failed / 未知值任务失败保留任务 ID,联系服务方核查。
客户 API 任务提示

任务处理中,message(网页任务同时有 msg)只返回“处理环境”“登录中”“订阅中”。完成、失败、取消后消息为空字符串,只通过 status 判断结果。网页任务不返回 error_code、login_error 或 payment_error;手机任务保留 raw_status。结果链接、凭证及结算字段继续按原规则返回。请求参数、卡密或鉴权错误仍通过 success:false 和 error/message 返回。

首次订阅状态

initial_subscription_status含义
pending尚未确认首次检测结果;不表示已通过。
clear首次确认无订阅,后续不重复检查。
preexisting首次已有订阅,后续开通已关闭;隐藏重试按钮。
managed本系统已有开通或完成阶段记录,后续不作首次拦截。

首次结果按邮箱保留。重提资料、换卡或重试都不会覆盖;你通过本系统开通的 12 个月不属于“首次已有订阅”。

请求被拒绝:错误码与 HTTP 状态
HTTPerror处理方式
400invalid_body / invalid_json / invalid_parameter检查 JSON、字段类型和必填项。
400twofa_error2FA 与辅助邮箱至少一项有效;备用码必须传字符串。
400invalid_plan / invalid_task_type / web_single_task_required请使用已开放的网页方案代码,每个 request_id 一个账号。
401missing_cdkey / invalid_cdkey检查鉴权与卡密。
403cdkey_disabled / insufficient_balance检查卡密状态及可用点数。
404task_not_found核对任务 ID 及所属卡密。
409dedicated_worker_required联系管理员先为卡密绑定专属 Worker;绑定前不能提交新订单或重启失败任务。
409idempotency_conflict同一 request_id 的请求内容不能改变。
409task_in_progress / task_not_cancellable查询原任务,不要重复提交。
409submission_limit_reached / plan_not_configured / plan_disabled / plan_price_not_configured联系服务方处理次数或方案。
409initial_already_subscribed首次已有订阅记录已保留,换卡不能解除。
5xx / 网络超时internal_error / 结果未确认先查询;需要重发时使用原 request_id 和原内容。

AI 对接提示词

复制以下内容发给其他模型,补上你的项目技术栈即可。真实卡密在运行环境配置。

网页端对接 · 可直接复制
使用当前公开 API 文档
请为我的项目对接 Pixel2 Cloud 网页订阅 API。
文档:https://pixel.geminixs.us/api-doc#web-subscriptions
错误对照:https://pixel.geminixs.us/api-doc#web-errors
接口:POST https://pixel.geminixs.us/openapi.php
我的项目技术栈:[在此填写]

请先阅读文档,再实现代码,不要凭空发明接口或字段:
1. 网页端使用 cdkd 点数卡,通过 Authorization: Bearer <卡密> 鉴权。卡密从环境变量读取,不写入源码、公开前端或日志。
2. action=get_balance 查询 available_points、reserved_points、spent_points。从 plans 读取该卡当前开放方案及 cost_points,不能写死套餐或点数;用 plan_code 区分不同业务,不要混用手机端 remaining_uses 或 Success/Failed 状态。
3. action=submit_task,每个账号一个稳定 request_id,传 task_type、email、password。twofa(Base32 密钥或字符串形式的8位备用码)与 recovery_email 至少一项有效。支持前导0,不能传6位动态验证码。
4. 保存 task_id 与 request_id,每5秒用 action=get_status、task_id 查询。data.status 为 queued/dispatched/running 时继续查询;succeeded/failed/cancelled 时结束轮询。HTTP 200、success:true 仅代表查询成功,不代表任务成功。
5. 同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。
6. 处理中仅显示 message 的三个阶段:处理环境、登录中、订阅中。终态 message 为空,按 status 显示成功、失败或已取消,不依赖错误原因字段。
7. initial_already_subscribed 表示检测到已有订阅。本轮应停止开通;用户明确重新提交失败订单时会重新检查。由本系统完成的阶段不重跑。
8. initial_subscription_unconfirmed 表示首次状态未确认,提示人工核查,不当作无订阅继续。点数结算以 settlement_status 为准:reserved冻结、captured消耗、refunded已退回;客户端不要重复退点。
9. action=cancel_task 只能取消 queued 任务。区分 HTTP 错误下的 error/message 与查询成功后的 data.status。未知错误提供兜底,展示任务ID便于排查。
10. 交付可运行代码、必要配置说明和模拟请求测试。不要调用真实账号付款,不使用管理端或 Worker 接口,不创建文档未公开的重置、重排或退款接口。
WEB CODE EXAMPLES

网页订阅多语言示例

示例自动选择当前开放的套餐,实际可用套餐和点数以该卡余额接口的 plans 为准,使用含前导 0 的 8 位备用码字符串;也可填写 Base32 2FA 密钥,或仅保留有效辅助邮箱并将 2FA 留空/省略。请求 ID 为示例值;为新订单生成并保存自己的 ID,网络重试保持不变。

加载网页订阅示例中…

以下原有余额、批量、取消和示例章节适用于手机 CDK / CDK1,保持每条扣 1 次。

01

手机卡密:查询余额与状态

POST

提交前检查剩余可用次数,以及当前卡密下的任务统计。

actionget_balance别名 stats
参数名类型必填说明
actionString是get_balance 或 stats
cdkeyString条件业务卡密;已通过请求头认证时无需填写
请求体
{
  "action": "get_balance",
  "cdkey": "YOUR_CARD_KEY"
}
成功响应
{
  "success": true,
  "message": "查询成功",
  "key_type": "subscribe",
  "remaining_uses": 9,
  "pending_queue_cost": 0,
  "status_counts": {
    "pending": 1,
    "running": 0,
    "success": 3,
    "failed": 0,
    "cancelled": 0
  }
}

remaining_uses 为当前剩余次数。提交时已扣次,所以 pending_queue_cost 固定为 0,不要再次扣减。统计不包含已删除的任务。

02

手机卡密:提交排队任务

POST

提交账号并加入队列。支持单条账号、JSON 数组或多行文本,三种格式一次只能选择一种。

客户卡密优先执行;自用卡密与无卡密任务按同一优先级排队。同级按提交时间先后执行,不打断已运行任务。自用卡密仍按每条任务扣 1 次。

actionsubmit_task别名 submit
参数名类型必填说明
actionString是submit_task 或 submit
cdkeyString条件业务卡密;使用请求头认证时可省略
emailString单条必填账号邮箱
passwordString单条必填账号密码,保留原始内容
twofaString单条必填2FA 密钥或 8 位备用码;兼容字段 totp。纯 8 位数字字符串会自动加 bym-,例如 "00123456" → "bym-00123456";已有前缀不重复添加。必须传字符串以保留前导 0,不是 6 位即时动态验证码。
tasksArray批量选一1–100 个账号对象;每项包含 email、password、twofa(或 totp)
account_dataString批量选一每行 邮箱----密码----2FA密钥或8位备用码,最多 100 行;手机端不支持辅助邮箱列。内容包含分隔符时请使用 JSON 数组
task_typeString否自动按卡密确定。若填写,只能为该卡对应的 run_all 或 extract_link
手机任务每条扣 1 次,整批一起成功或失败

余额不足、批内邮箱重复或任意账号不符合要求时,整批不提交、不扣次。同一邮箱已有排队或执行中任务时不可重复提交;默认每个邮箱累计最多提交 10 次(包含回收站记录),实际以服务方后台配置为准。

手机 CDK / CDK1 不接收 sub6 / sub12 / sub24,也不支持 recovery_email。手机失败任务仍沿用原手动清理退款流程;网页 cdkd 任务按上方独立点数规则处理。

单条请求 · 请求头已鉴权
{
  "action": "submit_task",
  "email": "[email protected]",
  "password": "YOUR_ACCOUNT_PASSWORD",
  "twofa": "YOUR_2FA_SECRET"
}
成功响应
{
  "success": true,
  "message": "已提交 1 条任务",
  "submitted_count": 1,
  "task_type": "run_all",
  "cost_per_item": 1,
  "remaining_uses": 9,
  "task_ids": [
    "550e8400-e29b-41d4-a716-446655440000"
  ],
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}
查看 JSON 数组批量提交示例 +
请求头已鉴权 · 两条任务扣 2 次
{
  "action": "submit_task",
  "tasks": [
    { "email": "[email protected]", "password": "PASSWORD_A", "twofa": "2FA_SECRET_A" },
    { "email": "[email protected]", "password": "PASSWORD_B", "totp": "2FA_SECRET_B" }
  ]
}
查看多行文本提交示例 +
请求头已鉴权 · 使用 \n 分隔账号
{
  "action": "submit_task",
  "account_data": "[email protected]_A----2FA_SECRET_A\[email protected]_B----2FA_SECRET_B"
}

请保存返回的 task_ids。仅单条提交额外返回 task_id,任务 ID 为字符串。请求超时后请先按邮箱查询,再决定是否重新提交。

03

查询任务状态

POST

仅查询当前卡密下的任务。按任务 ID 或邮箱查询单条;均不填写时分页获取任务列表。

actionget_status别名 detail / list
参数名类型必填说明
actionString是get_status、detail 或 list
cdkeyString条件使用请求头认证时可省略
task_idString否提交返回的 UUID;与 email 不可同时填写
emailString否精确匹配邮箱,返回该卡密下最新一条未删除记录
limitInteger否列表每页条数,默认 100,范围 1–1000
offsetInteger否列表偏移量,默认 0,必须为非负整数
单任务查询 · 请求头已鉴权
{
  "action": "get_status",
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}
完成响应示例
{
  "success": true,
  "message": "查询成功",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "[email protected]",
    "status": "Success",
    "raw_status": "done",
    "message": "",
    "task_type": "run_all",
    "link": "",
    "percent": 100,
    "created_at": "2026-11-06 12:00:00",
    "updated_at": "2026-11-06 12:03:00",
    "completed_at": "2026-11-06 12:03:00"
  }
}
查看列表查询及分页响应 +
请求体 · 请求头已鉴权
{
  "action": "list",
  "limit": 100,
  "offset": 0
}
空列表响应示例
{
  "success": true,
  "message": "查询成功",
  "data": [],
  "total": 0,
  "limit": 100,
  "offset": 0
}

列表的 data 为任务对象数组;单任务查询为对象。时间均为北京时间(UTC+8)。运行中 completed_at 为 null;完成后也不保证有结果链接,以 link 实际值为准。

04

取消排队任务

POST

取消当前卡密下尚未开始的任务,退还 1 次使用次数。正在执行或已结束的任务无法取消。

actioncancel_task别名 cancel
参数名类型必填说明
actionString是cancel_task 或 cancel
cdkeyString条件使用请求头认证时可省略
task_idString是本卡密下的排队任务 UUID
请求体 · 请求头已鉴权
{
  "action": "cancel_task",
  "task_id": "550e8400-e29b-41d4-a716-446655440000"
}
成功响应
{
  "success": true,
  "message": "任务已取消,已退还 1 次使用次数",
  "cancelled_count": 1,
  "refunded": 1,
  "remaining_uses": 10
}

取消成功后记录进入回收站,不再出现在 API 查询与统计中。再次取消返回任务不存在,不会重复退还次数。

CODE EXAMPLES

从一段代码开始

以提交单个任务为例。替换卡密和账号信息,即可从你的服务端发起调用。

# 加载调用示例中…

Python 示例需要安装 requests:pip install requests。

REFERENCE

手机端 · 状态与错误

请求成功返回 success: true。失败时同时检查 HTTP 状态码、error 和 message,不要仅以 HTTP 连接成功判断任务完成。

任务状态

statusraw_status含义与处理
Pendingqueued排队中,继续查询;可取消
Runningrunning执行中,继续查询
Successdone已完成,停止轮询并读取结果
Failedfailed 或具体错误状态执行失败,查看 message 与 raw_status
Cancelledcancelled已取消;通过本 API 取消的记录会移入回收站

建议每 3–5 秒查询一次,并设置总等待超时。网络失败时逐步延长间隔。设备重新排队可能使 Running 回到 Pending。原始失败状态包括 password_error、totp_error、totp_invalid、totp_not_enabled、ineligible、captcha、account_suspended、payment_error、account_error、google_server_error。

手机端 raw_status 错误对照
raw_status客户提示下一步
password_error密码错误核对账号密码。
totp_error / totp_invalid / totp_not_enabled2FA 验证失败或未开启检查密钥、备用码及账号验证设置。
ineligible账号不符合资格核对账号条件或更换账号。
captcha需要人机验证人工处理账号验证。
account_suspended / account_error账号状态异常先检查账号可否正常登录。
payment_error支付异常保存任务 ID 并联系服务方。
google_server_error / failed / 未知值服务异常或任务失败保存任务 ID,联系服务方核查。

手机任务失败沿用服务方原手动处理流程;不能按网页端 refunded 点数规则自行退款。

错误响应

HTTP 403 · 余额不足
{
  "success": false,
  "error": "insufficient_balance",
  "message": "卡密剩余次数不足,本次需要 1 次"
}
HTTPerror处理方式
400invalid_body / invalid_json检查 JSON 请求体及 Content-Type
400invalid_parameter / invalid_action检查必填字段、类型、action 和分页参数
400invalid_task_type / unsupported_parameter移除不支持的套餐、辅助邮箱等字段
400invalid_submission_format / batch_size_exceeded / duplicate_email只选一种格式,1–100 条账号且邮箱不重复
401missing_cdkey / invalid_cdkey提供有效业务卡密
403cdkey_disabled / insufficient_balance联系管理员检查卡密状态或可用次数
404task_not_found确认任务 ID 属于当前卡密且未被删除
405method_not_allowed请使用 POST 请求
409task_in_progress / submission_limit_reached / task_not_cancellable检查当前任务状态或历史提交次数
413payload_too_large缩小请求体;服务器上限为 10 MB
500internal_error稍后重试;提交操作先查询是否已创建任务
旧接口迁移

原 /open/* 接口与独立 API Key 已停用。请改用 /openapi.php、action 和业务卡密;响应使用 success / message,不再使用 code / msg。

手机端 · AI 对接提示词

适用于 CDK / CDK1。网页点数卡请选择上方“网页端 API”。

展开手机端对接提示词
请为我的项目对接 Pixel2 Cloud 手机端 API。
文档:https://pixel.geminixs.us/api-doc#submit
接口:POST https://pixel.geminixs.us/openapi.php
我的技术栈:[在此填写]

1. 使用 CDK / CDK1 业务卡密,通过 Authorization: Bearer <卡密> 鉴权;从环境变量读取,不记录密码、2FA或卡密。
2. action=get_balance 查询 remaining_uses。CDK自动对应run_all完整订阅,CDK1对应extract_link提链接;每个新任务扣1次,不使用网页点数、sub6/sub12/sub24或辅助邮箱字段。
3. action=submit_task,支持单个 email/password/twofa,或 tasks 账号对象数组,或 account_data 多行文本,三种格式只选一种,最多100条。twofa使用字符串Base32密钥或8位备用码,保留前导0;不要填6位动态码。
4. 批量提交为整体校验。任意一条参数错误、邮箱重复或余额不足都不会部分提交。保存返回的task_ids。
5. action=get_status,按task_id或email查询;data.status为Pending/Running/Success/Failed/Cancelled,data.raw_status保留具体错误类型。每5秒查询一次,终态停止。
6. 根据 status/raw_status 显示任务状态;处理中 message 只有处理环境、登录中、订阅中,终态为空,不返回内部原因。
7. action=cancel_task只可取消本卡queued排队任务,取消成功退1次并进入回收站。手机失败任务按服务方原流程处理,不仿照网页端自动退款,不自行修改次数。
8. 网络超时先用本卡查询原账号和任务,不盲目重新提交;手机端不要套用网页request_id幂等约定。区分请求success:false和查询成功但任务Failed。
9. 交付可运行代码、配置示例和模拟测试。不使用管理端/Worker接口,不调用真实账号付款,不发明未公开接口。