API 接入文档
先选择卡密类型,再按示例提交和查询。
当前:网页端 API。按点数结算,每个请求提交一个账号。
准备 cdkd 网页点数卡
每个账号使用独立 request_id
保存任务 ID,每 5 秒查询一次
所有操作使用同一地址,通过 action 区分。手机 CDK / CDK1 沿用每条扣 1 次;独立网页 cdkd 点数卡使用当前开放的套餐,详见网页订阅接口。两类卡密及任务分别处理。
请求与鉴权
直接使用业务卡密认证,无需额外的 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 调用。当前接口没有开放浏览器跨域访问,请勿将卡密写入公开前端代码。
网页端 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 / submit | request_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 / cancel | task_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 重试,服务端会返回原任务。不要为了重试生成新的 ID;同 ID 对应的账号或方案不能改变。
同卡、同邮箱、同方案的失败且已退款任务,使用新 request_id 再次提交即可沿用原任务 ID 重新排队,资料不变也可以。执行前删除旧浏览器配置并新建,保留原方案、价格、PSC 和已完成订阅阶段,只冻结未完成部分所需点数。取消任务仍需更改认证资料才重排。排队、运行中或已成功任务只保存资料,不重复执行。网络结果不明时沿用原 request_id 和原内容;重放不重复扣点,请以 status 判断当前状态。
{
"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 | 已取消,点数退回 |
任务失败时,查看 status 和结算状态,message 为空字符串。查看错误对照与处理方法 →
{
"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 筛选。 |
{
"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": ""
}{
"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_error | 2FA / 备用码错误,或没有可用验证方式 | 补充有效密钥、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 状态
| HTTP | error | 处理方式 |
|---|---|---|
| 400 | invalid_body / invalid_json / invalid_parameter | 检查 JSON、字段类型和必填项。 |
| 400 | twofa_error | 2FA 与辅助邮箱至少一项有效;备用码必须传字符串。 |
| 400 | invalid_plan / invalid_task_type / web_single_task_required | 请使用已开放的网页方案代码,每个 request_id 一个账号。 |
| 401 | missing_cdkey / invalid_cdkey | 检查鉴权与卡密。 |
| 403 | cdkey_disabled / insufficient_balance | 检查卡密状态及可用点数。 |
| 404 | task_not_found | 核对任务 ID 及所属卡密。 |
| 409 | dedicated_worker_required | 联系管理员先为卡密绑定专属 Worker;绑定前不能提交新订单或重启失败任务。 |
| 409 | idempotency_conflict | 同一 request_id 的请求内容不能改变。 |
| 409 | task_in_progress / task_not_cancellable | 查询原任务,不要重复提交。 |
| 409 | submission_limit_reached / plan_not_configured / plan_disabled / plan_price_not_configured | 联系服务方处理次数或方案。 |
| 409 | initial_already_subscribed | 首次已有订阅记录已保留,换卡不能解除。 |
| 5xx / 网络超时 | internal_error / 结果未确认 | 先查询;需要重发时使用原 request_id 和原内容。 |
AI 对接提示词
复制以下内容发给其他模型,补上你的项目技术栈即可。真实卡密在运行环境配置。
网页端对接 · 可直接复制
请为我的项目对接 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 接口,不创建文档未公开的重置、重排或退款接口。网页订阅多语言示例
示例自动选择当前开放的套餐,实际可用套餐和点数以该卡余额接口的 plans 为准,使用含前导 0 的 8 位备用码字符串;也可填写 Base32 2FA 密钥,或仅保留有效辅助邮箱并将 2FA 留空/省略。请求 ID 为示例值;为新订单生成并保存自己的 ID,网络重试保持不变。
加载网页订阅示例中…以下原有余额、批量、取消和示例章节适用于手机 CDK / CDK1,保持每条扣 1 次。
手机卡密:查询余额与状态
POST提交前检查剩余可用次数,以及当前卡密下的任务统计。
get_balance别名 stats| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | String | 是 | get_balance 或 stats |
cdkey | String | 条件 | 业务卡密;已通过请求头认证时无需填写 |
{
"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,不要再次扣减。统计不包含已删除的任务。
手机卡密:提交排队任务
POST提交账号并加入队列。支持单条账号、JSON 数组或多行文本,三种格式一次只能选择一种。
客户卡密优先执行;自用卡密与无卡密任务按同一优先级排队。同级按提交时间先后执行,不打断已运行任务。自用卡密仍按每条任务扣 1 次。
submit_task别名 submit| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | String | 是 | submit_task 或 submit |
cdkey | String | 条件 | 业务卡密;使用请求头认证时可省略 |
email | String | 单条必填 | 账号邮箱 |
password | String | 单条必填 | 账号密码,保留原始内容 |
twofa | String | 单条必填 | 2FA 密钥或 8 位备用码;兼容字段 totp。纯 8 位数字字符串会自动加 bym-,例如 "00123456" → "bym-00123456";已有前缀不重复添加。必须传字符串以保留前导 0,不是 6 位即时动态验证码。 |
tasks | Array | 批量选一 | 1–100 个账号对象;每项包含 email、password、twofa(或 totp) |
account_data | String | 批量选一 | 每行 邮箱----密码----2FA密钥或8位备用码,最多 100 行;手机端不支持辅助邮箱列。内容包含分隔符时请使用 JSON 数组 |
task_type | String | 否 | 自动按卡密确定。若填写,只能为该卡对应的 run_all 或 extract_link |
余额不足、批内邮箱重复或任意账号不符合要求时,整批不提交、不扣次。同一邮箱已有排队或执行中任务时不可重复提交;默认每个邮箱累计最多提交 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 数组批量提交示例 +
{
"action": "submit_task",
"tasks": [
{ "email": "[email protected]", "password": "PASSWORD_A", "twofa": "2FA_SECRET_A" },
{ "email": "[email protected]", "password": "PASSWORD_B", "totp": "2FA_SECRET_B" }
]
}查看多行文本提交示例 +
{
"action": "submit_task",
"account_data": "[email protected]_A----2FA_SECRET_A\[email protected]_B----2FA_SECRET_B"
}请保存返回的 task_ids。仅单条提交额外返回 task_id,任务 ID 为字符串。请求超时后请先按邮箱查询,再决定是否重新提交。
查询任务状态
POST仅查询当前卡密下的任务。按任务 ID 或邮箱查询单条;均不填写时分页获取任务列表。
get_status别名 detail / list| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | String | 是 | get_status、detail 或 list |
cdkey | String | 条件 | 使用请求头认证时可省略 |
task_id | String | 否 | 提交返回的 UUID;与 email 不可同时填写 |
email | String | 否 | 精确匹配邮箱,返回该卡密下最新一条未删除记录 |
limit | Integer | 否 | 列表每页条数,默认 100,范围 1–1000 |
offset | Integer | 否 | 列表偏移量,默认 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 实际值为准。
取消排队任务
POST取消当前卡密下尚未开始的任务,退还 1 次使用次数。正在执行或已结束的任务无法取消。
cancel_task别名 cancel| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
action | String | 是 | cancel_task 或 cancel |
cdkey | String | 条件 | 使用请求头认证时可省略 |
task_id | String | 是 | 本卡密下的排队任务 UUID |
{
"action": "cancel_task",
"task_id": "550e8400-e29b-41d4-a716-446655440000"
}{
"success": true,
"message": "任务已取消,已退还 1 次使用次数",
"cancelled_count": 1,
"refunded": 1,
"remaining_uses": 10
}取消成功后记录进入回收站,不再出现在 API 查询与统计中。再次取消返回任务不存在,不会重复退还次数。
从一段代码开始
以提交单个任务为例。替换卡密和账号信息,即可从你的服务端发起调用。
# 加载调用示例中…Python 示例需要安装 requests:pip install requests。
手机端 · 状态与错误
请求成功返回 success: true。失败时同时检查 HTTP 状态码、error 和 message,不要仅以 HTTP 连接成功判断任务完成。
任务状态
| status | raw_status | 含义与处理 |
|---|---|---|
| Pending | queued | 排队中,继续查询;可取消 |
| Running | running | 执行中,继续查询 |
| Success | done | 已完成,停止轮询并读取结果 |
| Failed | failed 或具体错误状态 | 执行失败,查看 message 与 raw_status |
| Cancelled | cancelled | 已取消;通过本 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_enabled | 2FA 验证失败或未开启 | 检查密钥、备用码及账号验证设置。 |
ineligible | 账号不符合资格 | 核对账号条件或更换账号。 |
captcha | 需要人机验证 | 人工处理账号验证。 |
account_suspended / account_error | 账号状态异常 | 先检查账号可否正常登录。 |
payment_error | 支付异常 | 保存任务 ID 并联系服务方。 |
google_server_error / failed / 未知值 | 服务异常或任务失败 | 保存任务 ID,联系服务方核查。 |
手机任务失败沿用服务方原手动处理流程;不能按网页端 refunded 点数规则自行退款。
错误响应
{
"success": false,
"error": "insufficient_balance",
"message": "卡密剩余次数不足,本次需要 1 次"
}| HTTP | error | 处理方式 |
|---|---|---|
| 400 | invalid_body / invalid_json | 检查 JSON 请求体及 Content-Type |
| 400 | invalid_parameter / invalid_action | 检查必填字段、类型、action 和分页参数 |
| 400 | invalid_task_type / unsupported_parameter | 移除不支持的套餐、辅助邮箱等字段 |
| 400 | invalid_submission_format / batch_size_exceeded / duplicate_email | 只选一种格式,1–100 条账号且邮箱不重复 |
| 401 | missing_cdkey / invalid_cdkey | 提供有效业务卡密 |
| 403 | cdkey_disabled / insufficient_balance | 联系管理员检查卡密状态或可用次数 |
| 404 | task_not_found | 确认任务 ID 属于当前卡密且未被删除 |
| 405 | method_not_allowed | 请使用 POST 请求 |
| 409 | task_in_progress / submission_limit_reached / task_not_cancellable | 检查当前任务状态或历史提交次数 |
| 413 | payload_too_large | 缩小请求体;服务器上限为 10 MB |
| 500 | internal_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接口,不调用真实账号付款,不发明未公开接口。