帮助与参考
本页统一说明文档与平台界面中出现的名词，避免同一概念在不同页面出现不同叫法。
| 术语 | 含义 |
|---|
| LocoPal Ai | API 平台，也是整个生态的核心：账号、登录、计费、模型目录、素材库与任务记录都由它提供。入口 locopalai.com。 |
| LocoPal Creation | 创作平台（网页工作台），面向不写代码的直接创作。入口 creation.locopalai.com。 |
| 控制台 | LocoPal Ai 登录后的管理界面，包含模型广场、API 密钥、日志、素材库管理、钱包等。 |
| 术语 | 含义 |
|---|
| API keys | 调用平台接口的凭据，形如 sk-...。一把 Key 可调用模型、图片、视频、音频和素材接口。 |
| Access Token | 短期调用令牌。平台前端只把它保存在内存里，不写入 localStorage。 |
| 刷新令牌 / 会话 Cookie | 用于在页面刷新后恢复登录态。作用域为 .locopalai.com，因此两个平台可共享登录。 |
| 统一登录 | 只在 LocoPal Ai 登录一次，其余平台自动获得登录态。LocoPal Ai 是唯一的身份来源。 |
| 登录态失效 | 退出登录、切换账号或修改密码后，两个平台的会话同时失效，需要重新登录。 |
| 术语 | 含义 |
|---|
| 模型 ID | 请求 model 字段要填的值，来自 GET /v1/models 返回的 data[].id。不是页面上展示的名称。 |
| 模型广场 | 查看模型名称、能力、参数、价格和可用分组的入口。 |
| 调用分组 / 分组 | 决定一把 Key 能看到和调用哪些模型的授权范围。一个分组下有若干渠道，渠道上挂若干模型。 |
| 渠道 | 分组下实际承载模型的通道。模型是否可用取决于当前能否路由到可用渠道。 |
| 基础地址（Base URL） | 接口前缀，如 https://locopalai.com。只写到域名，不要重复追加 /v1。 |
us-api.locopalai.com | 面向海外模型或特定网络环境的备用接入地址。用哪个地址就以该地址的 /v1/models 为准。 |
| 同步调用 | 请求返回时即拿到结果的调用，如文本、图片、音频。 |
| 异步任务 | 先创建任务拿到 ID、再轮询查询结果的调用，如视频生成。 |
| 术语 | 含义 |
|---|
| 素材库 | 平台统一的素材存储，按分组组织。入库一次即可被所有支持素材引用的模型复用。 |
| 素材分组 | 素材的容器，分为虚拟（virtual）与真人（real）两类。 |
| 虚拟素材 | 上传或生成的图片素材，适合保存角色、商品、风格等可复用资料。 |
| 真人素材 | 需由本人用手机扫码完成活体采集与授权的真人资料，不能用普通图片上传替代。 |
| 素材 ID | 素材的唯一标识，跨模型保持一致。 |
asset://<asset_id> | 在请求中引用已入库素材的写法。需等素材状态为 Active 后使用。 |
Active | 素材状态之一，表示素材已处理完成、可稳定用于支持素材引用的模型。 |
Processing | 素材仍在处理中。这不是错误，继续用同一素材 ID 轮询即可。 |
data_url | 内联提交图片数据的形式（data:image/...;base64,...），与 image_url 二者只能提交一个。 |
| 术语 | 含义 |
|---|
| 任务 ID | 异步任务的标识。创建后必须保存，本地超时也用查询而不是重建来跟踪。 |
| 任务日志 | 查看异步任务执行明细的入口，含提交时间、任务 ID、耗时、状态、进度与制品。 |
| 使用日志 | 查看同步调用明细的入口，含模型、Token 与费用。 |
queued / 排队中 | 任务已受理，等待执行。 |
processing / 生成中 | 任务执行中，可以离开页面，稍后回到原记录查看。 |
succeeded / 已完成 | 结果已生成，可下载或引用。 |
failed / 失败 | 任务终态失败。读取同一响应里的 error.code 与 error.message。 |
video_generation_failed | 视频任务的终态失败码，error.message 已是清理后的可读原因。 |
| 制品 | 任务产物，可直接预览或下载的图片、视频、音频。 |
| 请求快照 | 任务的请求内容与原始请求 JSON。仅管理员可见，普通用户查询自己的任务时不返回该字段。 |
| 术语 | 含义 |
|---|
| 按 Token 计费 | 按输入与输出 Token 分别计费，单位显示为 1K 或 1M Token。 |
| 缓存输入 / 缓存写入 | 支持提示词缓存的模型才会显示的计费项。 |
| 按次计费 | 每次成功请求按固定价格计费。 |
| 价格矩阵 | 视频模型按「是否含视频输入」×「输出分辨率」展示的价格表。 |
| 完成时结算 | 异步任务的实际扣费发生在任务完成时，提交只受理任务，不预先扣费。 |
| 钱包 | 充值、套餐、订单与账单记录的入口。 |
| 预估消耗 | 任务提交前的费用估算。余额不足以覆盖时会直接返回提示且不创建任务。 |
| 术语 | 含义 |
|---|
限流 / 429 | 请求过于频繁。按提示退避重试，不要并发重试。 |
task_concurrency_exceeded | 并发任务达到上限。保留已有任务 ID，等待后再由用户主动重新提交。 |
| 退避重试 | 失败后等待一段时间再重试，且逐次延长等待，而不是立即连续重发。 |
| RequestId / 请求 ID | 单次请求的标识，排查问题时用于定位具体记录。 |
400 参数校验失败 | 请求未被受理，通常不产生生成任务费用。 |
