帮助中心：账户、聊天、充值与 API 排查

开始使用

打开账户页面注册或登录，按页面提示完成验证。
在控制台查看账户可用模型、能力和售价。
打开余额与充值，选择付款方式并完成付款。
在API 密钥中为应用创建独立密钥。
填写接入地址、密钥和准确的模型 ID。先进行一次短文本测试，再逐步启用需要的功能。

实际模型调用会产生费用。仅打开本帮助页、搜索或复制示例不会调用模型。

账户与安全

网站登录凭证和 API 密钥用途不同：前者用于登录控制台，后者用于应用调用模型。第三方客户端不能使用你的登录密码代替 API 密钥。

收不到验证邮件时检查垃圾邮件、邮箱拼写和邮件规则。避免反复请求；保留错误提示并联系支持。不要向客服发送密码、验证码或恢复代码。

共享电脑使用完成后退出登录。个人应用和生产服务使用不同密钥，避免一把密钥用于所有设备。

创建、复制与撤销 API 密钥

在密钥页面输入便于辨认的名称，例如“工作电脑”或“生产服务”。
创建后复制完整密钥。列表中带省略号的前缀不能用于调用。
将密钥保存在客户端的凭据设置或服务器密钥管理系统中，不放进网页代码、公开仓库或截图。
设备丢失或怀疑泄漏时撤销对应密钥，创建新密钥并更新应用。

复制未成功时检查浏览器剪贴板权限，并在可信的本地位置确认；不要把完整密钥发到聊天中检查。撤销后原应用需要更新密钥才能继续调用。

充值、到账与余额

美元额度，人民币付款

账户额度以美元记账。选择微信支付或支付宝后，输入希望到账的美元金额，系统按订单汇率计算人民币实付金额。请核对收银页面显示的金额后付款。

汇率按日更新。新订单使用创建时的报价，已生成订单不会因之后的汇率变化重新计算。最终付款金额以订单为准，支付渠道或银行仍可能有自身限额。

付款步骤

选择付款方式并输入到账金额，生成付款链接。
使用对应应用扫码或按支付页面提示完成支付。
返回余额页面，查看最近充值订单是否显示“已到账”。

支付完成但未到账时先刷新订单，核对付款记录。不要因网页没有跳转而重复支付；联系支持并提供订单号、金额、时间和已脱敏的支付凭证。

未付款或二维码过期的订单不会增加余额。先确认未付款，再生成新订单。不要将付款二维码转发给陌生人，也不要向个人账户转账代替订单付款。

三个余额字段

账户余额: 账户当前记账余额。
预留金额: 请求执行或结算核对期间暂时占用的额度。
可用余额: 扣除预留后可用于新请求的额度。

请求可能先按输入和输出上限预留费用，再按实际用量结算。异常中断不等于未发生上游费用；长时间未释放的预留请提供请求 ID 交由支持核对。

为什么只发“你好”也有很多 Token？

输入不只包含你刚输入的文字，还可能包含历史消息、系统提示、工具定义和附件。Agent 多轮任务和重试会继续消耗用量。客户端费用常是本地估算，请对照 LINGJING 的用量和订单记录。

费用争议需逐笔核实，页面报错不等于自动退款。不要重复提交相同任务来验证是否扣费。

选择模型与理解能力

使用控制台或模型目录返回的准确 ID；展示名称与 API ID 可能不同。模型是否可见、能否调用、支持哪些输入与工具，需要分别确认。

文本对话、流式输出、工具调用、视觉理解、图片生成、视频生成、语音和向量检索不是同一种接口能力。不要把文本接口直接当作图片或视频生成接口，也不要仅依据模型名称开启客户端全部选项。

模型名称、能力和价格以账户当前目录为准。新模型需完成适配和验收后开放；上游账户已开通不等于 LINGJING 已上线。

Token 单价要区分未命中缓存输入、缓存命中输入和输出。长上下文阶梯、缓存写入或其他功能可能独立计费。当前支持的范围请先查模型配置，不能把未显示价格的功能理解为免费。

API 接入

OpenAI 兼容 Base URL: https://api.lingjing.win/v1
文本对话完整地址: https://api.lingjing.win/v1/chat/completions
认证头: Authorization: Bearer YOUR_LINGJING_API_KEY

客户端要求 Base URL 时填写到 /v1，不要重复追加 /chat/completions。要求完整接口地址时再填写完整路径。

查看模型目录（Bash / cURL）

先通过安全方式在本地设置环境变量 LINGJING_API_KEY，不要将真实密钥写入共享脚本。

curl --fail-with-body https://api.lingjing.win/v1/models \
  -H "Authorization: Bearer $LINGJING_API_KEY"

模型请求示例及语言切换见接入指南。先选账户中可用的模型，初次测试使用短输入、小输出上限，不开启自动重试。

请求 ID 用于排查与幂等处理。同一次请求的安全重试需遵守接口幂等约定；不要给所有新请求使用固定 ID。不要把 LINGJING 密钥用于登录 ChatGPT 或其他第三方会员服务。

客户端与 Agent 配置

LINGJING Agent

在“配置连接”填写你的 LINGJING API Key，同步模型目录，选择目录中可用的模型。新增模型是否可使用取决于服务端开放能力与客户端版本，不需要手工猜测型号。充值使用官方控制台入口。

WorkBuddy

进入自定义模型设置，按WorkBuddy 专属指南填写完整接口地址。此前验证覆盖 Haiku 4.5 基础对话与文件读写，不代表所有模型均支持工具或所有插件。

Cherry Studio

按Cherry Studio 指南配置 OpenAI 兼容服务。普通聊天与内置 Claude Code Agent 的运行要求不同。出现 API Gateway is disabled 时检查 Cherry 本地网关；启用时仅监听本机，不向公网开放。

Cline 与 Aider

使用对应的 OpenAI 兼容设置，参考客户端配置参数。先在隔离测试目录验证，保留文件修改和命令执行确认。部分验证仅覆盖特定版本及测试环境，不能作为全功能承诺。

未完成签名、商店审核或验收的客户端版本不应视为正式发布。只从官网列出的入口下载，不安装陌生人提供的包。

常见错误与处理

401：认证失败: 检查是否使用完整密钥、是否撤销、是否误填登录密码，以及认证头格式。不要公开密钥排查。
403：无权限: 检查账户及模型权限，不要反复重试绕过权限限制。
400：Unsupported fields / 参数不支持: 停止自动重试，恢复该模型的最小配置。检查思考字段、工具、附件、客户端附加元数据和输出上限。保留请求 ID 与错误文字；不要直接删改业务数据来碰运气。
上下文超限: 新建对话、缩减历史及附件，降低输出上限。客户端填写更大数字不会提高服务端上限。
余额不足: 查看可用余额及预留金额，不只看账户余额。确认充值订单已经到账。
409：请求冲突或已有请求: 先查原请求状态，避免用新 ID 重复发起同一项收费任务。
429：频率或并发限制: 降低并发，遵循 Retry-After。确认限制原因后做有次数上限的退避重试。
5xx、超时或连接中断: 记录时间和请求 ID，先检查用量记录。输出中断不代表上游没有生成内容或费用。
持续显示“重试中”: 先停止任务；400 等固定参数错误通常不会通过重复发送自行修复。恢复配置后用新对话进行一次短测试。

隐私、数据与工具权限

不要把密码、支付凭证原件、个人敏感信息或未经授权的文件放入模型请求。应用需要把请求内容交给相应模型服务处理，不能将模型网关理解为所有数据都只留在本地。

Agent 只授予完成任务需要的目录和工具权限。涉及删除、发布、付款或执行命令时保留确认步骤。帮助客服不需要你的完整 API Key，也不应替你绕过安全限制。

联系支持

使用与配置客服 · contact@lingjing.win

请提供：发生时间及所在时区、客户端名称与版本、模型 ID、请求 ID 或充值订单号、脱敏错误文字，以及复现步骤。截图请遮住密钥、验证码和个人信息。

已启用受限 AI 辅助答复，内容限定于已审核的 LINGJING 使用与配置文档。客服费用由 LINGJING 承担，不扣账户余额；每账户每日按采购成本限制为 20 美元，不计销售加价，北京时间零点重置。额度用完后仍可获取免费文档答复。无关问题不调用模型、不消耗 Token。客服不能代替人工处理退款、账户权限或账单争议；不要向客服输入密钥。

LINGJING 帮助中心