常见问题

账号与新人体验

收不到注册验证码

检查邮箱地址、垃圾邮件和拦截规则，稍后重新发送。不要连续高频点击验证码按钮。

邮箱提示已经注册

返回登录页尝试登录或找回密码，不要为同一邮箱重复创建账号。

已经入群，为什么没有新人体验

新人体验不是入群即自动发放。确认使用注册账号对应 QQ 入群并发送正确注册邮箱，等待管理员添加约 $10 GPT Pro API 新人体验订阅。

怎么联系支持或加入官方群

点击加入 Lunora 官方 QQ 群。联系支持或申请新人体验时优先提供完整注册邮箱，不要只发昵称或用户序号。

充值、余额与权益

兑换失败

检查兑换码是否完整、是否已使用、余额码与订阅码类型是否匹配。联系支持时提供注册邮箱、操作时间和兑换码尾号。

余额或累计充值没有更新

刷新余额、权益等级和用量记录，确认本次操作属于兑换充值、线下充值还是平台补偿。平台补偿不会计入累计充值和等级加赠。

充值后没有获得加赠

兑换码充值和管理员标记的线下充值可以按当前规则参与；平台补偿、抽奖奖励和活动赠送不会产生充值加赠。

为什么余额和订阅额度不是同一个数字

余额按模型和倍率支付请求消耗；订阅额度只在对应订阅分组和有效期内使用。两者独立显示和计算。

余额或订阅会过期吗

订阅通常有有效期；余额和其他权益以控制台当前说明为准。不要根据其他站点规则推断 Lunora。

API Key 与客户端

API 接口有哪些

帮助中心当前整理了 Chat Completions、Responses、图片生成与编辑、异步图片任务，以及 OpenAI / Omni 和 Grok 视频任务。完整路径与请求示例见API 接口参考。

API 根地址应该怎么填

API 根地址是 https://api.uselunora.com。Chat Completions、生图和视频脚本使用对应的完整 /v1/... 路径；Codex 的 base_url 使用不带 /v1 的根地址。不要把控制台网页地址当作 API 地址，也不要重复添加 /v1。

视频接口从哪里开始

先在可用渠道确认视频模型和 Key 分组，再根据模型使用 /v1/videos 或 /v1/video/generations。完整任务提交、轮询和下载示例见视频 API。

401 或 403

检查 Key 是否完整、是否已停用、API 地址是否正确，以及 Key 分组是否包含目标模型。兑换码不是 API Key。

404

通常是 API 地址或路径拼接错误。确认客户端需要基础地址还是完整端点，避免重复添加 /v1 或具体接口路径。

429 或 503

429 常见于并发、余额、订阅额度或渠道限制；503 通常表示当前服务或上游暂不可用。降低并发，检查渠道状态后再试。

502

先查看可用渠道，切换当前可用线路。短时间内不要连续高速重试。

客户端完全连不上

确认 Base URL 使用 Lunora 当前地址，并检查本地代理、防火墙、CC Switch 当前供应商和路由模式。多个配置工具同时运行时可能互相覆盖。

CC Switch 导入后仍然使用旧配置

确认 Lunora 供应商已经切换为当前启用项、本地路由总开关处于关闭状态，并完全退出目标客户端的后台进程后重开。不要同时运行多个配置管理器。

Claude Code 应该填写哪个地址

ANTHROPIC_BASE_URL 填写 https://api.uselunora.com，末尾不要添加 /v1、/v1/messages 或 /v1/chat/completions。

Codex 应该填写哪个地址和协议

config.toml 中的 base_url 填写 https://api.uselunora.com，并使用 wire_api = "responses"。修改后必须彻底重启桌面应用、重载 IDE 窗口或重开终端。

WorkBuddy 应该填写哪个地址

WorkBuddy 的自定义模型接口地址填写完整端点 https://api.uselunora.com/v1/chat/completions。它和 Codex、Claude Code 的地址格式不同。

修改配置没有生效

彻底退出客户端和后台进程，重新打开终端或重载 IDE 窗口。多数客户端只在启动时读取配置。

模型不可用

模型名称和可用范围会变化。以控制台“可用渠道”页面当前显示为准，并确认 API Key 分组匹配。

首次响应或思考速度变慢

先用简短文本测试，并记录请求时间、模型和渠道。速度可能同时受到线路、上游负载、模型思考和请求长度影响，不能只根据服务器瞬时带宽判断。

API Key 泄露了怎么办

立即停用泄露 Key，创建新 Key 并更新所有工具配置，然后检查泄露时间后的请求记录。已经公开过的 Key 不应继续使用。

为什么 WorkBuddy 找不到刚添加的模型

新模型一般位于模型选择器下方的“自定义模型”区域，不在内置模型列表。返回配置页确认已保存，仍不显示时重启 WorkBuddy。

WorkBuddy 是否需要授权整个磁盘

不需要。第一次只授权专门准备的测试目录，后续再按实际工作增加目录。不要授权存放密码、财务和私人备份的目录。

OpenCode 为什么看不到 Lunora Provider

检查 ~/.config/opencode/opencode.json 是否为有效 JSON，Provider ID 与凭证中的 ID 是否都为 lunora，然后完全重启 OpenCode。详见OpenCode 接入。

Cherry Studio 应该选择哪个 Provider

Responses 模型选择 OpenAI-Responses；普通 Chat Completions 模型选择对应的 OpenAI 兼容类型。地址填写 https://api.uselunora.com/v1。详见Cherry Studio 接入。

Kilo Code 需要开启 YOLO Mode 吗

不需要，也不建议。YOLO/自动批准会允许插件未经逐项确认执行命令和修改文件。保持关闭，只批准自己理解的操作。详见Kilo Code 接入。

OpenClaw 修改配置后没有生效

检查 openclaw.json 的 JSON 结构、Provider 与模型 ID，然后执行 openclaw gateway restart。详见OpenClaw 接入。

Claude Code 为什么需要 ccNexus 才能调用 Codex 模型

Claude Code 使用 Anthropic 协议，Codex 模型通常使用 Responses。ccNexus 在本机完成协议转换；关闭它后 localhost 地址就不可用。详见Claude Code 调用 Codex 模型。

Gemini CLI 应该填写哪个地址

GOOGLE_GEMINI_BASE_URL 填写 https://api.uselunora.com，不要手动拼接具体模型动作路径。详见Gemini CLI 接入。

Trae 找不到自定义模型

先升级 Trae，关闭 SOLO 的 AUTO 模式，再到模型配置中的“自定义配置”添加。保存后在模型下拉列表底部查找。详见Trae 接入。

AI 生图

聊天 Key 可以直接拿来生图吗

不一定。只有 Key 分组包含当前生图模型时才可以。聊天和生图属于不同分组时，需要单独创建生图 Key，不能只看 Key 都是同一种格式。

网页生图和直接 API 的地址为什么不同

网页工作台 API URL 填写 https://api.uselunora.com/v1；直接调用生图接口使用完整地址 https://api.uselunora.com/v1/images/generations。

环境变量已经设置，脚本为什么读不到

环境变量只会传给新启动的进程。保存后关闭旧终端和调用脚本的应用，再重新打开；验证时只输出变量长度，不要打印完整 Key。

开启流式传输，为什么没有中间过程图

是否返回中间图取决于模型和上游接口。开启流式传输但只有最终图，不代表任务失败。

开启和关闭流式传输都失败

继续检查模型映射、Key 分组、上游路由、余额、图片格式和服务端错误，而不是只反复切换流式开关。

生成成功但图片无法打开或下载

先从历史记录重新打开结果。如果任务成功但资源加载失败，保留时间和任务编号联系支持，不要立即反复付费重试。

API 返回了内容但没有图片文件

先查看完整 JSON。不同模型可能返回图片 URL 或 data[0].b64_json；只有返回 base64 时才需要解码保存，不能假设所有模型使用同一个字段。

Codex 里怎么直接生成图片

先让 Codex 使用聊天 Key 正常接入 Lunora，再安装 GPT Image 2 Skill，并单独把生图 Key 保存为 GPT_IMAGE_2_API_KEY。完整步骤见在 Codex 中生图。

为什么 Codex 聊天正常，生图却返回 403

聊天 Key 和生图 Key 可能属于不同分组。不要依赖 .codex/auth.json 中的聊天 Key 回退；为 Skill 单独配置拥有生图权限的 GPT_IMAGE_2_API_KEY，然后完全重启 Codex。

Codex 安装 Skill 时路径怎么填

先把 gpt-image-2.zip 解压，并记住解压后的 gpt-image-2 文件夹路径。然后在 Codex 输入 $skill，选择 Skill Installer，发送 请安装这个skill：你的实际文件夹路径。不要填写 ZIP 压缩包路径，完整流程见在 Codex 中生图。

生图为什么比文本慢

图片生成通常包含排队、上游生成和结果下载三个阶段。先用默认尺寸测试，再判断具体慢在哪个阶段。

AI 视频

为什么提交后没有立即返回视频

视频接口是异步任务。创建请求先返回 id 或 task_id，程序需要保存它并每 5-10 秒查询一次，直到完成、成功或失败。不要把“已排队”当作生成失败。

/v1/videos 和 /v1/video/generations 有什么区别

OpenAI 兼容和 Omni 视频使用 /v1/videos；Grok 视频使用 /v1/video/generations。两套接口的查询状态和成片字段不同，不能只替换模型名而保留错误路径。

参考图片或视频为什么读取失败

URL 必须能从公网直接访问，不能依赖登录、Cookie、防盗链或本地网络。上传本地文件时，按教程使用对应的 multipart 字段。详见视频 API。

邀请与抽奖

新人体验到账了，为什么邀请人没有返利

新人体验是赠送订阅，不属于有效充值。它可以用于新人验证和活动资格；邀请返利仍需受邀用户完成符合当前规则的有效充值。详见邀请返利与额度转余额。

返利额度为什么不能立即转入余额

新产生的返利可能处于冻结期，还可能受单用户上限、每日上限和全站预算影响。以邀请返利页面“当前奖励规则”显示为准。

邀请成功但没有抽奖次数

受邀用户需要完成当前活动要求的有效邀请验证，而不是只注册账号。确认活动正在进行、受邀用户已获得新人体验资格，并刷新活动页。

充值后没有抽奖次数

确认充值发生在活动期间并属于符合规则的兑换码充值或线下充值。平台补偿和活动赠送不属于真实充值。

中奖弹窗关闭后兑换码不见了

返回活动页打开“我的奖励”或抽奖记录，重新查看并复制完整兑换码。不要只依赖一次性中奖弹窗。

批量生图

为什么批量生图页面没有可选 Key

批量生图只显示所属分组已开启该能力的 Gemini API Key。普通文本或普通生图可用，不代表已经开启批量能力。详见批量生图与结果下载。

一次最多可以生成多少张

每条 prompt 最多 4 张，一组任务预计输出总数最多 200 张。超过限制应拆成多组任务。

为什么任务取消后仍有扣费

取消只停止尚未完成的部分；已经被系统记录为成功的图片仍按成功项结算，其余冻结金额按规则释放。

部分失败是否需要重做整个任务

不需要。使用“重试失败项”只提交失败明细，避免重复生成已经成功的图片。

联系支持前准备

为了更快定位问题，请准备：

• 注册邮箱。
• 问题发生时间。
• 使用的客户端、模型和分组。
• 完整错误文字或截图。
• 相关请求、任务或兑换记录编号。

不要发送完整 API Key、完整兑换码或包含隐私信息的图片。