派云AI Tokens1688 用户使用手册

一、平台简介

派AI | tokens1688 专注于提供便捷、稳定的 AI tokens 服务，整合 40+ 主流大模型资源。用户仅需一个账号和一个统一令牌，即可快速接入 OpenAI、Claude、Gemini、通义千问、kimi、DeepSeek、GLM 等模型能力，并支持 OpenAI 标准协议，降低开发接入成本，提升 AI 应用构建效率。

核心亮点

• 多模型聚合：一次接入，随时切换，避免多平台账号管理
• 充值卡包：按需补充账户余额，购买后核对到账记录
• 按量计费：账户余额按模型调用消费，用量与扣费可查询
• 兼容 OpenAI 协议：现有代码几乎零改动即可迁移
• 可视化面板：额度、日志、统计一目了然

二、快速开始：注册与登录

2.1 打开官网

https://www.tokens1688.com/

2.2 注册账号

点击右上角「注册」按钮，支持以下方式：

按当前注册页面选择可用方式，输入所需资料、设置密码并完成验证码验证；手机号入口仅在平台启用时可用。

2.3 登录进入控制台

注册完成后登录控制台。左侧菜单与默认落地页受平台配置和账户权限控制，可从可见菜单进入数据看板、充值卡包、令牌管理等页面。

三、充值卡包与余额管理

3.1 充值卡包购买

进入「充值卡包」，查看卡包名称、售价、到账额度与购买条件，核对后选择卡包并确认支付。支付完成后核对订单状态及账户余额；异常时带订单号联系支持，不重复付款。

3.2 体验卡兑换

持有兑换码时进入「体验卡包」，按页面要求输入并核对后确认兑换，再查看兑换记录的额度、状态与时间。不要公开兑换码；重复失败应联系支持。充值卡包用于购买，体验卡包用于兑换。

3.3 余额与消费核对

账户余额按模型调用消费。调用前核对所选模型价格、计费单位与可用余额，调用后结合使用日志核对实际扣费。余额、令牌额度上限是不同层级；设置令牌限额不会增加账户余额。

在「充值卡包」查看账户余额、累计充值与消费趋势，并结合数据看板、使用日志及统计报表核对。

3.4 订单与发票

「订单发票」用于查看订单与开票记录，不是充值入口。核对订单号、金额、支付方式和完成时间；需要开票时选择符合条件的订单，填写并核对抬头、税号及联系资料后提交，随后跟踪状态。

开票：选择订单号并点击「开票」提交开票申请

3.5 邀请管理

进入「邀请管理」页面，您可以复制邀请码链接，二维码或推广页并发送给您的用户，您可以在下方查看您邀请的用户。

四、创建 API 令牌

API 令牌（Token）是您调用模型的凭证。同一账号可创建多个令牌，用于不同项目隔离用量，初始令牌是否存在以令牌列表为准。（如需多人使用，请添加多个令牌进行分配，系统自动按照令牌统计使用量）

4.1 创建步骤

1. 进入左侧菜单「令牌管理」
2. 点击右上角「添加令牌」
3. 填写名称（如：我的项目A）、额度上限、可用模型范围、有效期
4. 保存后，点击「复制」拿到形如 sk-xxxxxx 的密钥

4.2 令牌安全建议

• 妥善保管，不要提交到公开代码仓库
• 每个项目使用独立令牌，方便审计和吊销
• 设置额度上限，避免异常调用消耗过多
• 长期不用的令牌及时禁用或删除

五、调用模型（二种方式）

5.1 方式一：OpenAI 兼容 API 调用

平台完全兼容 OpenAI Chat Completions 协议，将原有代码的 base_url 换成本平台地址、api_key 换成本平台令牌即可。

from openai import OpenAI

client = OpenAI(
    api_key="sk-您的令牌",
    base_url="https://www.tokens1688.com/v1"
)
resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

curl https://www.tokens1688.com/v1/chat/completions \
  -H "Authorization: Bearer sk-您的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"你好"}]}'

5.2 方式二：查看可用模型列表

进入「可用模型」页面，可查看当前账户/令牌所支持的全部模型清单，包括模型名称、倍率、单价。

六、第三方客户端接入

支持自定义 OpenAI 接口地址的应用/插件可按协议、模型与功能匹配情况接入本平台；并非所有客户端均可无缝兼容。以下列举常见客户端配置示例。

通用配置

6.1 WorkBuddy接入使用

保存后即可在workbuddy中选择自定义模型使用

6.2 Codex/Claude Code/OpenClaw等其他智能体接入使用

从cc switch官网下载cc switch，链接：CC Switch 官方网站 - AI 编程工具统一管理平台

可支持常用的AI Agent如：

Claude Code， Codex， OpenClaw(小龙虾)， Hermes(爱马仕) 等

API Key：sk-您的令牌

七、查看用量与日志

7.1 数据看板

「数据看板」页面展示您的额度使用情况、消耗趋势、模型分布，帮助您掌握用量。

7.2 使用日志

「使用日志」页面记录每一次调用的模型、时间、token 数、消耗额度、状态。支持按时间、模型、令牌名筛选，方便排查问题。

7.3 统计报表

「统计报表」按日期范围筛选，可按天或小时查看汇总，并按令牌、模型分析消耗、成功率与平均用时，适合核对账单。

多人使用时可根据令牌名称查看每个令牌使用数据

也可以查看不同模型的消耗数据

7.4 模型状态

「模型状态」用于观察模型可用性；统计范围以当前页面说明为准，历史状态不保证后续请求成功。

八、个人信息管理

8.1个人信息

「个人信息」页面展示您的个人信息，可以更新您的资料或者修改账号信息。

8.2开票信息

企业用户请务必填写开票信息方便开票。

点击新增抬头添加开票信息。

8.3修改密码

您可随时修改密码，忘记原密码时请通过邮箱重置，建议设置高强度密码

九、常见问题（FAQ）

Q1：充值卡包与体验卡包有什么区别？

充值卡包用于购买并补充账户余额；账户余额按模型调用消费，实际扣费可在使用日志核对。

体验卡包用于输入兑换码并领取对应额度，兑换后核对记录与到账结果。

可用模型由账户权限、令牌限制和模型状态决定，不应仅凭充值或兑换推断模型权限。

充值与兑换请分别使用对应入口。

Q2：为什么调用返回 401 / 无权限？

• 确认使用的是本平台令牌 sk-xxxxxx，而不是 OpenAI 官方 key
• 确认 base_url 已改成 https://www.tokens1688.com/v1/chat/completions
• 确认令牌未被禁用、未超出额度、未过期
• 确认令牌允许调用该模型（可在令牌设置里放开）

Q3：为什么某个模型不能用？

可能原因：当前账户无该模型权限 / 令牌未勾选该模型 / 模型暂时下线维护。请到「可用模型」页确认。部分模型暂时不支持读取图片功能，会返回400错误。

Q4：可以退款吗？

退款条件以购买时展示的协议和平台说明为准。提交前核对订单、消费状态，必要时咨询平台支持。

十、体验中心

体验中心包括文本、图像、视频与漫剧。菜单仅在当前账户有权限且平台启用时显示；生成可能计费。以下为文字操作指引，模型和模式是否可用以当前页面与账户权限为准。

10.1 文本体验

进入体验中心的文本入口（/console/experience/chat），选择当前可用模型，输入问题并核对选项后发送；需要上下文时继续同一对话。涉及上传或工具调用时先确认模型支持，避免输入敏感资料。发送会发起模型调用并可能扣费。

10.2 图像体验

进入图像入口（/console/ai-generation），选择模型，填写画面描述，按页面提供的参数设置尺寸或其他选项；仅在页面支持时提供参考图。核对价格与参数后生成，查看结果或任务状态。参数与下载方式以当前模型界面为准。

10.3 视频体验

进入视频入口（/console/video-generation），选择模型并填写提示词；参考素材、时长、画幅等仅按当前页面开放项填写。提交前核对计费规则，提交后查看任务进度与失败提示，勿因等待重复创建付费任务。

10.4 漫剧体验

进入漫剧入口（/console/infinite-canvas），按页面开放的画布和内容组织功能规划文本、画面或视频素材，再逐项确认生成。具体节点、流程、保存和导出能力以现场界面为准；请依实际页面完成操作，生成流程和成片能力以所选功能为准。

十一、模型中心

模型中心按文本、图片、视频、边缘算力分类，入口分别为 /console/model-center/text、/console/model-center/image、/console/model-center/video、/console/model-center/edge。

1. 切换所需类型，搜索名称并使用当前页面的分组或标签筛选。
2. 查看模型描述、上下文上限、计费类型、输入/输出价格、分组和倍率（仅限页面实际显示字段）。
3. 在「可用模型」确认账户/令牌权限，复制实际 model_name；营销标题不一定是 API 模型名。
4. 调用前核对协议与图片输入、工具调用等能力。边缘算力是分类入口，不表示账户已部署设备或开通推理权限。

十二、组织机构与权限条件

组织机构入口为 /console/sub-accounts，仅在平台启用且当前角色具备权限时可见。普通个人用户不必创建组织；缺少入口时联系团队主账号或平台支持，不绕过权限。

1. 有权限的主账号可按界面查看部门、子账号、显示名称、分组、额度上限、已用额度、请求数、最后使用时间与状态。
2. 需要管理时先规划部门与成员额度，再按页面创建部门或子账号；填写后核对并确认。额度调整、停用与创建均是写操作。
3. 子账号消费从主账号钱包扣除并受子账号额度上限约束；子账号不能充值或兑换卡。成员令牌仅用于调用鉴权，不替代成员权限管理。
4. 定期结合组织用量与使用日志核对权限，避免将团队密钥发给无关人员。

十三、消费清单、任务日志与导出

13.1 消费清单导出任务

进入「消费清单」（/console/export），检查可选清单类型、对象或令牌及时间范围，确认后创建导出任务。创建会写入任务记录；下载的消费明细请妥善保管。

1. 创建前选择所需范围，避免导出无关成员数据。
2. 在列表查看任务编号、类型、对象、令牌、状态、创建时间、记录数/大小与有效期。
3. 按当前状态等待处理；失败时查看 error_message，修正条件后再重试，勿重复提交大量任务。
4. 任务完成后，在权限允许且有效期内使用页面下载入口。文件含消费明细，请保存在受控位置；过期时依页面规则重新创建。

13.2 任务日志与用量核对

「任务日志」用于查看平台开放的任务执行记录，与逐次 API 使用日志及消费清单导出任务列表不同。按页面可用条件筛选，结合状态与错误提示排查；没有日志或入口不代表任务一定未执行，应结合请求结果和消费记录核对。

附录 A：菜单可见性与权限

菜单由平台总开关、账户菜单配置与角色权限共同决定。本手册介绍普通用户流程，不代表所有账号都能看到全部入口。钱包管理、绘图日志、个人设置、模型部署等入口可能关闭，需以当前控制台为准。

渠道用户可能看到渠道或业务专属菜单，普通用户不应据此操作渠道管理。绩效管理中的示意或占位数据不能当作真实业务统计或结算依据。渠道专属权限和结算须由平台另行确认；本手册不包含任何具体账号身份或私人数据。

附录 B：版本与使用说明

版本 V4.0，更新日期 2026-10-12。本版按充值卡包、体验卡兑换与余额按调用消费的流程说明，操作界面以当前平台实际展示为准。

模型协议兼容性需依实际模型验证。接入时请确认所选模型支持的协议、功能与参数，并将示例模型名称替换为当前可用模型；实际调用遵守账户权益与计费规则。

令牌管理补充：可按页面配置分组、有效期、额度上限、模型限制与允许 IP；无限额度仅取消令牌自身限额，仍受账户实际余额约束。

客户端配置补充：字段要求 Base URL 时填写 https://www.tokens1688.com/v1；要求完整 Chat Completions 地址时填写 https://www.tokens1688.com/v1/chat/completions，避免重复拼接。接入步骤随客户端版本可能变化，使用前核对对应协议。