帮助与参考
使用指南
更新日志
使用手册的结构调整与接口说明变更记录
更新日志
本页记录使用手册文档的结构调整与接口说明变更,方便已经接入的开发者对照检查。
文档只描述当前有效的行为;如与你的历史实现不一致,请以本手册和 GET /v1/models 的实时结果为准。
本次更新(文档规范化)
导航结构
使用手册改为按使用路径组织,共六个分区:
| 分区 | 内容 |
|---|---|
| 快速开始 | 快速开始、平台功能指南、模型广场与计费、常用工具接入 |
| 平台总览 | 四个平台的定位、功能与常见问题 |
| API 接入 | 认证规范、接口总览、文本、图片、视频、音频、错误码 |
| 素材库 | 素材库指南、素材库接口、人像流程、参考视频 |
| 网页创作 | Creation 工作台与 Agent、视频生成与重试、常见问题 |
| 帮助与参考 | 常见问题汇总、计费与账单、限流与配额、更新日志、术语表 |
顶部标签与侧边栏同步更新。所有原有地址保持不变,已分享给客户的链接继续有效。
新增内容
- 新增「帮助与参考」分区:常见问题汇总、计费与账单、限流与配额、更新日志、术语表;
- 新增文本转语音接口的独立说明页;
- 补齐四个平台页的功能清单、典型工作流与常见问题;
- Canvas 页补充节点类型、常用操作、快捷键与完整创作流程示例;
- 文档索引补充音频接口与平台总览入口。
修正内容
- 修正 Canvas 页指向未发布页面的失效链接;
- 修正文档总入口的视频接口链接,改为直达创建任务页;
- 修正文档索引遗漏的音频接口条目,与接口总览保持一致。
概念澄清
以下行为在手册中做了明确说明,接入时请特别注意:
| 主题 | 说明 |
|---|---|
| 完成时结算 | 异步任务在完成时结算,提交只受理任务,不预先扣费 |
| 查询不计费 | 查询任务状态不产生费用,只有创建任务才计费 |
| 不合并重复请求 | 相同参数重复提交会创建新任务并各自计费,平台不做自动合并 |
| 素材只需入库一次 | 素材 ID 跨模型保持一致,切换模型只需改 model 字段 |
| 真人素材不可降级 | 切换到不支持真人素材的模型时不会自动改成普通参考图 |
| 请求快照权限 | 请求内容与请求 JSON 仅管理员可见,普通用户查询时不返回该字段 |
如何确认当前行为
文档描述的是设计行为,实际的模型可见范围必须以实时结果为准:
curl "$LOCOPAL_BASE_URL/v1/models" \
-H "Authorization: Bearer $LOCOPAL_API_KEY"模型目录会随账户授权、接入地址和平台可用性变化。建议在服务启动、用户切换模型, 或收到「模型不可用」时重新查询,不要写死模型名称。
相关文档
这一页有帮助吗?
