使用指南
平台功能指南
首页、模型广场、API 密钥、日志、账单、素材库与 LocoPal Creation 的使用说明
平台功能指南
本页按日常使用顺序介绍 LocoPal Ai 的主要功能。登录后只会看到当前账户的密钥、任务、素材和账单。
首页与模型广场
首页和顶部产品入口提供控制台、使用手册、模型广场和 LocoPal Creation。模型广场集中展示模型名称、能力、参数和计费详情。
选择模型时依次确认：
- 模型能力与业务类型一致，例如视频任务选择视频模型；
- 模型 ID 出现在当前 API Key 的
/v1/models响应中； - 请求参数属于模型详情展示的支持范围；
- 预计价格符合预算，最终以实际账单为准。
控制台概览
控制台用于查看余额、套餐、调用量、消耗趋势和近期记录。统计数据用于定位高消耗模型和异常峰值，账单明细用于核对最终费用。
API 密钥
API Key 是调用模型、图片、视频、音频和素材接口的唯一凭据，同一把 Key 在所有接口之间通用。建议按「生产服务」「测试环境」「客户应用」分别创建，并设置清晰的名称、额度和有效期。
| 操作 | 说明 |
|---|---|
| 创建 | 生成新的调用凭据，创建后只应保存在服务端。 |
| 编辑 | 调整名称、额度、模型分组和有效期。 |
| 禁用 | 临时阻止该 Key 发起请求，可用于止损。 |
| 删除 | 永久移除不再使用的 Key。 |
| 日志筛选 | 按 Key 区分不同应用的调用记录。 |
删除或禁用 Key 不会删除该账户的素材、任务和历史记录，重新创建 Key 后仍可继续使用原有素材。
使用日志与任务日志
使用日志记录同步调用，可按时间、API Key、模型、分组、请求标识和状态筛选。任务日志用于视频、音频等异步业务，创建任务后应保存任务 ID；等待时间变化不代表重新计费，只有重新创建任务才会产生新的任务身份。
任务日志会显示提交时间、任务 ID（含上游任务编号）、耗时、状态、进度和详情。任务成功后在「详情」列会出现「点击预览视频」，点击即可在弹窗里直接播放生成的视频，弹窗内可以复制播放地址，不需要先下载再查看。管理员在任务日志中查看其他账号的任务时同样可以直接预览。
日志只展示当前账户自己的记录。
素材库管理
素材库是素材分组的集合，提供虚拟人物和真人素材两个类别。
虚拟人物
- 点击「新建分组」，选择「虚拟人像」，填写分组名称和说明（名称和说明都可以留空，留空时平台会自动命名，例如「虚拟人像素材 09-11 21:05」）；
- 在分组内点击「上传图片」直接选择本地图片，或用「提交素材」填写可公开访问的 http(s) 图片地址；
- 素材提交是异步处理，状态显示为「可用」后即可稳定用于支持素材引用的模型；
- 支持重命名素材、刷新状态和删除；删除分组前需要先移走或删除分组内的素材。
提交素材时「素材名称」也可以留空，平台会按上传文件的文件名命名；需要改名时在素材列表里重命名即可。
真人素材
真人素材必须由本人完成手机端采集与授权：
- 点击「新建分组」，选择「真人素材库」；
- 阅读并勾选授权协议，生成二维码；
- 由真人本人用手机扫码完成采集、授权和资料填写；
- 回到网页点击「已完成扫码，开始同步」；
- 页面显示真人分组和采集产生的素材，仍在处理时稍后刷新。
真人分组与发起扫码的当前账户绑定，其他账户不能解析或复用该会话。如果创建授权会话时提示暂不可用，请保留提示信息并联系平台支持。
查找与筛选
- 搜索：分组列表和素材列表都支持按名称或 ID 搜索；
- 筛选：可按分组类型和所属模型筛选，只看会用于某个模型的分组与素材；
- 所属模型：列表里只显示第一个模型名和一个
+N计数，鼠标移到上面会列出这个分组或素材的全部所属模型； - 分页：列表分页加载，底部显示总条数，并可以选择每页显示 10 / 20 / 50 / 100 条（默认 10 条）；
- 刷新：重新读取当前账户分组和素材的名称、状态、错误信息与访问地址。
素材只需要入库一次
不需要为每个模型分别建分组或上传素材。入库时素材进入平台统一素材库，凡支持素材引用的模型都直接使用同一份素材，素材 ID 保持不变，因此可以直接在模型之间复用，也不需要等待模型侧同步。模型与素材库的对应关系见素材库接口。
在此之前的存量素材会在首次被某个模型引用时由平台准备一次，准备完成后与直接引用的素材行为一致。
逐库核对（管理员）
管理员的素材库管理顶部可以在「平台素材库」和各个模型的素材库之间切换：切到某个模型的素材库后，可以只读地查看该库里的分组与素材（默认只显示模型名称），也可以在库里直接新建分组、提交素材，用于特殊准备和排查。库里的提交素材同样支持直接上传图片，名称留空会按文件名自动命名。
余额、充值与账单
余额页用于充值、查看套餐或兑换权益。模型广场提供估算价格，任务完成后的账单提供最终结算。核对异常扣费时使用任务 ID、请求标识、模型 ID 和时间范围，不要提供完整密钥。
LocoPal Creation
- LocoPal Creation：面向直接创作的工作台，提供智能模式、AI 绘图、AI 视频、AI 音频、短剧、作品、素材和提示词等入口；
Creation 复用同一 LocoPal 账户与模型服务，生成结果、任务和素材按当前登录用户隔离。
常见工作流
API 接入
创建 API Key → 查询模型 → 发起测试调用 → 在日志核对 → 接入业务服务 → 设置超时与错误处理。
多图与参考视频
准备公网媒体或状态为「可用」的素材 → 创建异步视频任务 → 保存任务 ID → 查询直到终态 → 下载或转存结果。
真人视频
创建真人授权会话 → 本人扫码采集 → 解析会话 → 查询真人素材状态 → 素材可用后提交支持真人素材库的视频任务。