跳到主要内容
LocoPal AiLocoPal Ai
帮助与参考

使用指南

更新日志

使用手册的结构调整与接口说明变更记录

查看 Markdown

更新日志

本页记录使用手册文档的结构调整与接口说明变更,方便已经接入的开发者对照检查。 文档只描述当前有效的行为;如与你的历史实现不一致,请以本手册和 GET /v1/models 的实时结果为准。

本次更新(文档规范化)

导航结构

使用手册改为按使用路径组织,共六个分区:

分区内容
快速开始快速开始、平台功能指南、模型广场与计费、常用工具接入
平台总览四个平台的定位、功能与常见问题
API 接入认证规范、接口总览、文本、图片、视频、音频、错误码
素材库素材库指南、素材库接口、人像流程、参考视频
网页创作Creation 工作台与 Agent、视频生成与重试、常见问题
帮助与参考常见问题汇总、计费与账单、限流与配额、更新日志、术语表

顶部标签与侧边栏同步更新。所有原有地址保持不变,已分享给客户的链接继续有效。

新增内容

  • 新增「帮助与参考」分区:常见问题汇总、计费与账单、限流与配额、更新日志、术语表;
  • 新增文本转语音接口的独立说明页;
  • 补齐四个平台页的功能清单、典型工作流与常见问题;
  • Canvas 页补充节点类型、常用操作、快捷键与完整创作流程示例;
  • 文档索引补充音频接口与平台总览入口。

修正内容

  • 修正 Canvas 页指向未发布页面的失效链接;
  • 修正文档总入口的视频接口链接,改为直达创建任务页;
  • 修正文档索引遗漏的音频接口条目,与接口总览保持一致。

概念澄清

以下行为在手册中做了明确说明,接入时请特别注意:

主题说明
完成时结算异步任务在完成时结算,提交只受理任务,不预先扣费
查询不计费查询任务状态不产生费用,只有创建任务才计费
不合并重复请求相同参数重复提交会创建新任务并各自计费,平台不做自动合并
素材只需入库一次素材 ID 跨模型保持一致,切换模型只需改 model 字段
真人素材不可降级切换到不支持真人素材的模型时不会自动改成普通参考图
请求快照权限请求内容与请求 JSON 仅管理员可见,普通用户查询时不返回该字段

如何确认当前行为

文档描述的是设计行为,实际的模型可见范围必须以实时结果为准:

curl "$LOCOPAL_BASE_URL/v1/models" \
  -H "Authorization: Bearer $LOCOPAL_API_KEY"

模型目录会随账户授权、接入地址和平台可用性变化。建议在服务启动、用户切换模型, 或收到「模型不可用」时重新查询,不要写死模型名称。

相关文档

这一页有帮助吗?

本页目录