常见问题汇总

本页按主题汇总平台使用中的高频问题。每个条目给出原因和可执行的下一步；更细的接口级排查见 错误码与排查，创作工作台的问题见 网页创作常见问题。

账号与登录

为什么打开 Creation 又让我登录？

LocoPal Ai 是唯一的身份来源。Creation 依赖 locopalai.com 下发的跨子域会话 Cookie， 如果该 Cookie 失效或不存在，子平台会跳回统一登录页。

先确认：打开 LocoPal Ai 是否处于登录状态。若它已登录而子平台仍显示未登录， 刷新该子平台页面；仍然不行时，在 LocoPal Ai 退出后重新登录一次。

换了电脑还需要单独登录 Creation 吗？

不需要。在 LocoPal Ai 登录一次，Creation 会自动获得登录态。

修改密码或退出登录会影响其他平台吗？

会。退出登录、切换账号、修改密码都会让 Creation 同步失效，这是同一套会话的正常行为。

API 密钥

一把 Key 能调用所有接口吗？

能。模型、图片、视频、音频和素材接口共用同一把 Key，不需要按接口分别创建。

为什么这把 Key 看不到某个模型？

模型可见范围由 Key 所属的调用分组决定。用该 Key 请求 GET /v1/models 确认： 如果返回的 data 里没有该模型，说明它不在这个分组的授权范围内。

返回 "data": [] 是什么意思？

表示当前 Key 所属分组下没有任何可用模型。先确认分组配置是否正确，仍有疑问时联系平台支持并提供 Key 名称（不要提供完整 Key）。

Key 泄露了怎么办？

立即在控制台「API 密钥」里禁用该 Key（而不是等它自然过期），然后为业务创建新 Key 并替换配置。 禁用不影响账号下的素材、任务和历史记录。

为什么不能把 Key 写在前端代码里？

浏览器和移动端安装包里的任何内容都可能被提取。Key 必须放在服务端环境变量或密钥管理服务中， 由你的业务后端代为调用平台。

模型与调用

请求里的 model 该填什么？

填 GET /v1/models 返回的 data[].id，原样填写。不要使用模型广场页面上展示的显示名称。

提示「模型暂不可用」或「无可用渠道」

表示当前时段无法路由到该模型，不代表 Key 有问题。先刷新模型列表或改用同类模型； 持续不可用时联系平台支持并提供请求 ID。

文本调用返回空的 content，finish_reason 是 length

推理模型可能把 max_tokens 全部消耗在推理过程（completion_tokens_details.reasoning_tokens）上。 提高输出上限，或改用非推理模型后重试。

图片接口报 unknown_parameter

部分图片模型（如 GPT Image 系列）不接受 response_format 字段。移除该字段后重试即可。 size、quality、response_format 的支持情况都以当前模型为准。

返回的图片 URL 打不开

图片接口返回的可能是短期地址，请尽快转存到自己的存储。需要长期复用的图片应先入库到素材库， 再通过 asset://<asset_id> 引用。

视频任务

为什么视频是异步的？

视频生成耗时较长，平台用「创建任务 → 查询结果」的方式处理。创建接口返回任务 ID， 再用查询接口轮询进度和结果。

提交后本地等待超时，要重新创建吗？

不要。 拿到任务 ID 后即使本地超时，也只能继续查询原任务。重新创建会产生重复任务和重复费用。

创建响应里没有 progress，是失败了吗？

不是。创建响应只需依赖 id / task_id、status、model 和 created_at； object、progress 等字段可能要到首次查询才出现，不能把它们当作创建成功的必要条件。

状态是 failed，怎么看原因？

读取同一响应里的 error.code 和 error.message。视频终态失败通常是 video_generation_failed， error.message 已是清理后的可读原因，不要再解析其中的 JSON。

查询时会重复计费吗？

不会。查询只读取状态，不产生费用。只有重新创建任务才会产生新的费用，这也是不要重复提交的原因。

素材与真人授权

需要为每个模型分别上传素材吗？

不需要。素材只需入库一次，进入平台统一素材库；凡支持素材引用的模型都使用同一份素材， 素材 ID 保持不变，切换模型只需改请求里的 model 字段。

素材什么时候才能用？

data.asset.status 变为 Active 后才稳定可用。显示「上传中」「处理中」时请保留并等待， 不要对同一失败项连读重复提交。

提交素材用什么图片地址？

用可从公网直接下载的 http(s) 地址，或按接口限制提交 data_url。 不要把浏览器本地文件路径当作接口参数。

真人素材可以用普通图片代替吗？

不能。 真人素材必须由本人用手机扫码完成活体采集与授权。 控制台流程为「素材库管理 → 新建分组 → 真人素材库 → 生成二维码 → 本人扫码 → 已完成扫码，开始同步」。

切换到不支持真人素材的模型会怎样？

真人素材只在明确支持它的模型上生效。切换到不支持的模型时，平台不会自动把它降级成普通参考图， 请改用虚拟素材或切回支持的模型。

素材会影响其他模型吗？

入库与模型无关。素材状态变为可用后即可在任意支持素材引用的模型中使用，不需要等待模型侧再次准备。 存量素材会在首次被引用时由平台准备一次。

计费与余额

提交视频任务就扣费了吗？

没有。异步任务在完成时结算，提交成功只受理任务，不会预先扣费。 提交前平台会校验余额或 Key 额度能否覆盖本次预估，不足时直接返回可读提示，不会创建任务。

参数校验失败（400）会扣费吗？

通常不会。400 表示请求未被受理，一般不会产生生成任务费用。

价格卡片上的价格就是最终扣费吗？

不等于。价格卡片用于估算，实际扣费以请求实际使用量、所属分组和服务端账单记录为准。 详见计费与账单。

觉得扣费异常，该怎么核对？

用任务 ID、请求标识、模型 ID 和时间范围定位到具体记录，再对照账单明细。不要提供完整密钥。

平台与创作工具

两个平台是什么关系？

LocoPal Ai 是核心，提供账号、计费、模型、素材与任务记录；Creation 是接入它的客户端。 详见平台总览。

在 Creation 里生成的素材，API 能用吗？

能。两者共用同一份素材库，素材 ID 也相同。

刷新页面会重新生成或重复扣费吗？

不会。刷新只恢复页面状态，不会重新创建任务，也不会重复计费。不要对仍在执行的任务重复提交。

仍然没有解决

提交支持请求时请提供：发生时间、模型名称、任务 ID 或请求 ID、HTTP 状态（接口调用时）、 脱敏后的错误信息，以及请求类型（文本 / 图片 / 视频 / 音频）。

不要提交：API keys、完整 Authorization 请求头、登录 Cookie、真实人像资料， 或带签名的完整素材地址。相关范围见错误码与排查。