平台功能指南

本页按日常使用顺序介绍 LocoPal Ai 的主要功能。登录后只会看到当前账户的密钥、任务、素材和账单。

首页与模型广场

首页提供控制台、模型广场、使用手册、LocoPal Creation、LocoPal Canvas 和 Agent 的入口。模型广场集中展示模型名称、能力、参数和计费详情。视频模型的详情按分辨率、时长、是否含视频输入等维度展示支持范围和价格。

选择模型时依次确认：

1. 模型能力与业务类型一致，例如视频任务选择视频模型。
2. 模型 ID 出现在当前 API Key 的 /v1/models 响应中。
3. 请求参数属于详情页展示的支持范围。
4. 预计价格符合预算，最终以实际账单为准。

控制台概览

控制台用于查看余额、套餐、调用量、消耗趋势和近期记录。统计数据用于定位高消耗模型和异常峰值，账单明细用于核对最终费用。

API 密钥

API Key 用于文本、图片、视频、音频等模型接口。建议按“生产服务”“测试环境”“客户应用”分别创建，并设置清晰名称、额度和有效期。

使用日志与任务日志

使用日志记录同步模型调用，可按时间、API Key、模型、分组、请求标识和状态筛选。任务日志用于视频等异步业务，创建任务后应保存任务 ID；等待时间变化不代表重新计费，只有重新创建任务才会产生新的任务身份。

任务日志只展示当前账户创建的任务。

素材库管理

素材库提供虚拟人物与真人素材两个类别。

虚拟人物

点击“新建分组”，选择虚拟人物，填写名称和说明。创建成功后可向分组添加图片、视频或音频。素材提交是异步处理，状态为 Active 后才能稳定用于支持素材引用的模型。

真人素材

点击“新建分组”，选择真人素材。页面不会要求预先填写分组名称，而是按以下步骤进行：

1. 阅读并勾选真人素材授权及个人信息处理协议。
2. 生成二维码。
3. 用户本人用手机扫码并完成采集、授权、名称和说明填写。
4. 回到网页点击“已完成扫码，开始同步”。
5. 页面显示真人分组和采集产生的素材；仍在处理时可稍后刷新。

真人分组与发起扫码的当前账户绑定，其他账户不能解析或复用该会话。

AccessKey 管理

AccessKey / SecretKey 是素材 API 的签名凭据，不是展示项。创建后可以实际调用虚拟素材、真人授权和状态查询接口。

• AccessKey 可在列表中识别、停用和删除。
• SecretKey 只在创建时显示一次。
• 每次调用根据请求体、时间和路径计算签名。
• 服务端会校验凭据所属用户，不能访问其他用户的分组或素材。

余额、充值与账单

余额页用于充值、查看套餐或兑换权益。模型广场提供估算价格，任务完成后的账单提供最终结算。核对异常扣费时使用任务 ID、RequestId、模型 ID和时间范围，不要提供完整密钥。

LocoPal Creation、Canvas 与 Agent

• LocoPal Creation：对话式图片、视频、音频和短剧创作，支持素材引用、任务状态与原位重试。
• LocoPal Canvas：无限画布式创作工具，适合组织多素材与并行任务。
• Agent：以自然语言组织多步骤工作，模型和参数由平台根据当前能力规划。

三个应用基于同一 LocoPal 账户与模型服务。生成结果、任务和素材按当前登录用户隔离。

常见工作流

API 接入

创建 API Key → 查询模型 → 发起测试调用 → 在日志核对 → 加入业务服务 → 设置超时与错误处理。

多图与参考视频

准备公网媒体或 Active 素材 → 创建异步视频任务 → 保存任务 ID → 查询直到终态 → 下载或转存结果。

真人视频

创建真人授权会话 → 用户扫码采集 → 解析会话 → 查询真人素材状态 → 仅在可用后提交支持真人能力的视频任务。