API 文档
API 接口总览
LocoPal Ai 模型、视频、素材与真人授权接口导航
接口路径、认证方式、参数与任务状态说明
API 接口总览
所有示例使用 https://locopalai.com。示例密钥、模型 ID、任务 ID、素材 ID 和媒体 URL 都是占位值，调用时必须替换。
接口分类
| 分类 | 方法与路径 | 鉴权 | 说明 |
|---|---|---|---|
| 模型目录 | GET /v1/models | API Key | 查询当前 Key 可用模型。 |
| 文本对话 | POST /v1/chat/completions | API Key | 同步或流式文本生成。 |
| 图片生成 | POST /v1/images/generations | API Key | 图片生成。 |
| 视频创建 | POST /v1/video/generations | API Key | 文生视频、图生视频、多图与参考视频。 |
| 视频查询 | GET /v1/video/generations/{task_id} | API Key | 查询异步任务状态和结果。 |
| 素材接口 | POST /api/v3?Action=...&Version=2024-01-01 | AccessKey 签名 | 虚拟分组、素材、审核状态与真人扫码授权。 |
两套凭据
模型接口使用：
Authorization: Bearer sk-your-api-key
Content-Type: application/json素材接口使用 AccessKey / SecretKey，客户端必须发送 X-Date、X-Content-Sha256 和 HMAC-SHA256 Authorization。SecretKey 只保存在调用方服务端。
典型调用链
模型与视频
查询模型 → 创建请求 → 保存请求或任务 ID → 查询异步任务 → 记录结果和用量。
虚拟素材
CreateAssetGroup → CreateAsset → GetAsset → 状态为 Active → 使用 asset://<ASSET_ID>。
真人素材
CreatePortraitSession → 展示二维码 → 用户本人完成授权采集 → ResolveBytedToken → ListAssets / GetAsset → 状态为 Active。
响应与错误
模型 API 按兼容协议返回 error；素材 API 在 ResponseMetadata.Error 返回错误。业务校验错误可能仍使用 HTTP 200，因此客户端必须同时检查响应体。
创建异步视频后必须保存任务 ID。网络断开时继续查询原任务，不要自动再创建一个相同任务。