从第一次登录，到发行自己的额度卡

先确认你是哪种使用者

52Token 同时服务自用账号、额度卡创建者和收到额度卡的使用者。角色不同，入口也不同，不需要把所有功能都学一遍。

注册用户第一次使用

1. 完成注册并登录，在控制台确认当前余额和可用分组。
2. 自用时创建普通密钥；需要发行额度卡时进入“提链中心”。
3. 先做一次小额请求，在使用记录中核对模型、Token、费用和延迟。

成功消费形成积分，次日签到有机会获得余额奖励

积分用于记录账户持续使用情况。系统只统计已成功结算的余额消费，不把充值、失败请求、退款或冻结金额当成有效消费。

如何查看和签到

1. 登录后从左侧菜单打开“积分中心”，查看总积分、昨日积分和消费曲线。
2. 每日 00:05 后刷新页面，确认前一自然日消费已经结算。
3. 签到功能开放且满足最低消费条件时，点击“今日签到”。
4. 以页面返回的到账结果为准，可在“签到奖励记录”中再次核对。

积分与余额的区别

• 消费积分是活跃度记录，不等同于现金余额。
• 总积分累计保留，昨日积分只对应前一自然日。
• 签到奖励到账后才进入可用余额。
• 策略调整按生效日期执行，不回改已结算记录。
• 失败、取消或已退款消费不会重复产生积分。
• 异常状态不要连续点击，先刷新奖励记录确认结果。

提链中心把账户余额转换成可独立交付的额度卡

提链 Key 本身就是额度卡卡密。创建者先从自己的余额预充值，购买者收到完整 Key 后无需注册 52Token，即可在额度卡中心激活和使用。

创建一张额度卡

1. 登录后进入“提链中心”，在创建区选择可用分组。
2. 填写单张充值金额和创建数量，先核对页面计算的总扣款。
3. 提交后等待成功结果，再从“我的额度卡”列表复制完整 Key。
4. 把完整 Key 交付给购买者，提醒其前往 key.52token.org 激活。
5. 后续需要续费时，由创建者在提链中心找到该 Key 并充值。

状态与可执行操作

收到额度卡后，无需注册即可查看额度和请求记录

购买者只需要完整 Key。额度卡中心不会提供充值、退款、编辑或创建者资料，这些操作由创建者或管理员处理。

1. 打开 key.52token.org，确认浏览器地址和 HTTPS 证书正常。
2. 输入完整额度卡 Key，点击“验证并激活”。连续输错会触发临时安全锁定。
3. 激活后查看剩余额度、分组名称、Token、缓存、费用、类型和延迟记录。
4. 从额度详情页复制完整 Key，并按接入教程填写 API Base 和模型名称。
5. 额度耗尽后联系销售者充值，充值足额后 Key 会自动恢复使用。

用清晰额度、自动交付和可查记录建立稳定的销售体验

创建者可以在闲鱼、小红书等渠道销售预充值额度卡。商品描述应聚焦无需注册、额度透明、使用记录可查和售后边界清楚，不使用“永久免费”“绝对稳定”或“官方授权”等无法持续保证的表述。

100U 额度卡的示例账目

示例按 8 / 0.08 = 100U 换算。实际净收益还应扣除交易平台费用、退款损耗和售后成本。下游额度卡成功产生的消费记录归属创建者账户，符合积分策略的部分会在次日结算为创建者消费积分，以积分中心实际记录为准。

发布商品前的检查清单

• 先用一张小额卡完成激活和请求测试。
• 商品规格明确写清 1x 额度，不混用创建成本。
• 自动发货只发送对应订单的一张完整 Key。
• 商品主图和公开描述不展示任何真实 Key。
• 写明数字商品交付后退款和售后处理边界。
• 保留订单号、交付时间和提链中心资金记录。

可直接调整的文案模板

标题示例 1：100U 智能工具额度卡｜自动发货｜用量可查｜无需注册
标题示例 2：即买即用额度卡 100U｜独立查询页｜记录透明

短卖点：
• 付款后自动交付，收到即可激活
• 无需注册额外账号，完整 Key 直接接入
• 剩余额度和每次使用记录随时可查
• 额度不足可联系销售者续费

【商品内容】
100U 1x 口径预充值额度卡一张。

【交付方式】
付款后自动发送完整额度卡 Key 和激活地址，无需等待人工发货。

【使用方式】
1. 打开 https://key.52token.org
2. 输入完整 Key 并激活
3. 查看剩余额度、使用记录和接入教程
4. 客户端 API Base 填写 https://api.52token.org/v1

【使用特点】
无需额外注册；额度清晰；Token、费用和延迟记录可查；用完可联系续费。

【售后说明】
请先用小请求完成配置验证。因客户端配置问题可提供接入说明；已激活并产生消耗的数字额度按实际使用记录处理。

【重要提醒】
完整 Key 等同于余额凭证，请勿公开、转发或截图展示。

您的 52Token 额度卡已自动发货。

额度规格：100U
激活地址：https://key.52token.org
额度卡 Key：CARD_KEY
API Base：https://api.52token.org/v1

首次使用：打开激活地址，输入完整 Key。激活成功后即可查看额度、复制 Key 和阅读接入教程。

安全提醒：请勿把完整 Key 发布到评价、群聊或公开截图中。额度不足时请凭订单号联系本店续费。

激活失败：请确认复制的是完整 Key，并检查前后是否带空格。连续输错后请等待页面提示的解锁时间再试。

看不到额度：请刷新额度详情页；仍异常时提供订单号和脱敏 Key，完整 Key 不要发到公开聊天。

客户端无法连接：请确认 API Base 为 https://api.52token.org/v1，Key 使用完整额度卡 Key，并从额度详情页选择可用模型。

显示欠费：最后一笔请求可能形成后扣欠费，请联系销售者充值。足额充值后会自动恢复，无需重新激活。

安全与准备

1. 登录控制台，在“密钥管理”中创建一枚用户密钥。
2. 在“可用渠道”页面确认该密钥可使用的模型名称和请求类型。
3. 根据客户端要求，手动填写 Base URL、协议类型、模型名和密钥。
4. 先发起一次小请求验证配置，确认使用记录与客户端结果一致。

域名与端点职责

请按功能使用对应域名，不要将下载域名当成生成接口。

客户端手动配置

先从客户端官方发布渠道安装软件，再在客户端本地设置页面中填写下列字段。本站不提供远程自动安装或覆盖本地配置的文件。

Codex 兼容客户端

Claude Code 兼容客户端

Gemini CLI 兼容客户端

CC Switch 一键导入

1. 在本机安装并启动你信任的 CC Switch 客户端。
2. 登录 52Token，进入“密钥管理”，在目标密钥右侧点击“导入到 CC Switch”。
3. 如果页面要求选择客户端类型，请根据该密钥的分组协议选择。
4. 系统打开本机 CC Switch 后，核对 Provider 名称、端点域名和模型，确认无误再完成导入。

OpenClaw、Hermes 与 TRAE SOLO

这些客户端的配置页面名称可能随版本变化，请以客户端官方说明为准。

文本与内容生成接口

文本接口统一使用 https://api.52token.org。以下是接口契约说明，不是可直接执行的命令。

通用请求要求

• JSON 请求必须声明 Content-Type: application/json。
• model 必须与可用渠道页面显示的模型名完全一致。
• 长时间文本任务应使用协议支持的流式模式，例如 Responses/Chat 的 stream=true 或 Gemini 的 streamGenerateContent?alt=sse。
• 非流式请求如果超过边缘网络的无响应等待上限，可能在模型完成前中断，因此不适合作为长任务调用方式。
• 流式请求由客户端按 SSE 或对应协议消费，不要将中途断开自动视为未请求。
• 工具调用字段应按客户端协议发送，不要同时混用多种协议的工具结构。

图片生成与编辑

图片创建和编辑使用 image.52token.org。可用模型以当前密钥的可用渠道为准。

OpenAI Images 兼容字段

参考图和本地预览

• 图片编辑请求将参考图作为 multipart 文件字段上传。
• Gemini 生图客户端应按 SSE 逐条读取 data: 事件并忽略以冒号开头的协议心跳，直到收到完成事件。
• 画布工作台会将生成结果保存在客户端本地存储中，预览时使用本地 Blob 地址。
• 如返回签名图片地址，域名应为 video.52token.org；请不要修改地址中的任何部分。
• 同步生成耗时较长时请保持连接；已有任务 ID 时应继续查询，不要重复创建。

视频生成任务

当前 9 个公开视频模型共用同一套创建、查询和下载接口。固定 480p 后缀模型已下架；标准按次模型是否支持 resolution=480p 以下方限制为准。

创建任务步骤

1. 使用 Authorization: Bearer <key> 鉴权，JSON 请求声明 Content-Type: application/json。
2. 请求体至少包含 model 和 prompt，按模型要求增加时长、分辨率和参考素材。
3. 建议每个业务任务设置唯一 Idempotency-Key，同一任务恢复时继续使用原值。
4. 保存创建响应中的平台任务 ID，后续仅用该 ID 查询。

任务状态与轮询

视频通用字段

9 个视频模型的字段和限制

是否可调用以当前密钥的可用渠道为准。以下模型都使用同一套任务接口。

比例限制

完成后的视频地址

• 任务成功后，查询响应可能在 url、video_url或结果对象中返回平台地址。
• 对外可见的完成地址应使用 video.52token.org，地址中不包含上游主机名。
• 下载地址是短期签名地址，应尽快下载到客户端本地。
• 视频播放器可按需使用 Range 分段请求；不要把地址作为永久公开链接。

错误、超时与重试

兼容性与授权声明