Growth Studio OpenAPI接入文档 · Getting Started
本文档面向通过服务端接入 Growth Studio 视频生成能力的外部调用方。
https://growth.pixverse.ai “设置” → “API 密钥”https://growth-api.pixverse.aiv1/openapi/v1正式环境域名由 Growth Studio 提供。请直接使用 HTTPS,不要先请求 HTTP 再跟随重定向。
当前开放以下接口:
| 分类 | 方法 | 路径 | 说明 |
|---|---|---|---|
| 基础能力 | POST |
/openapi/v1/image/upload |
上传商品或自定义模特图片 |
| 基础能力 | POST |
/openapi/v1/video/upload |
通过 URL 导入视频 |
| 基础能力 | GET |
/openapi/v1/avatars |
系统模特图 |
| 基础能力 | POST |
/openapi/v1/folders |
创建文件夹 |
| 基础能力 | GET |
/openapi/v1/folders |
获取文件夹列表 |
| 商品视频 | POST |
/openapi/v1/videos |
创建视频生成任务 |
| 模板创作 | GET |
/openapi/v1/template/list |
筛选、分页查询模板及计价规则 |
| 模板创作 | GET |
/openapi/v1/template/tags |
查询模板筛选标签 |
| 模板创作 | POST |
/openapi/v1/template/generate |
创建一条模板视频 |
| 旧模板接口(已弃用) | GET |
/openapi/v1/video-templates |
旧模板目录,迁移至 /template/list |
| 旧模板接口(已弃用) | POST |
/openapi/v1/template/videos/generations |
旧模板生成,迁移至 /template/generate |
| 爆款复刻 | POST |
/openapi/v1/viral-clone/runs |
创建爆款复刻任务 |
| 爆款复刻 | GET |
/openapi/v1/viral-clone/runs/{run_id} |
查询爆款复刻任务 |
| 批量裂变 | POST |
/openapi/v1/variation/videos/generations |
逐条指定人物、场景和语言,批量创建裂变视频 |
| 视频查询与编辑 | GET |
/openapi/v1/videos/{video_id} |
查询视频详情和生成结果 |
| 视频查询与编辑 | GET |
/openapi/v1/videos |
滚动分页查询视频列表 |
| 视频查询与编辑 | POST |
/openapi/v1/videos/{video_id}/edit |
启动agent视频片段替换任务 |
| 商品套图 | POST |
/openapi/v1/product-suite/images/generations |
创建商品套图 |
| 商品套图 | GET |
/openapi/v1/product-suite/images/generations/{task_id} |
查询商品套图及逐张结果 |
| 费用与账单 | GET |
/openapi/v1/wallet/discount |
查询当前折扣与有效期 |
| 费用与账单 | GET |
/openapi/v1/wallet/ledgers |
查询钱包流水与折前原价 |
当前版本不提供 webhook。任务受理后,请按接入指南(接入流程)中对应的查询入口轮询最终结果。
正式环境 API Key 以 mh_live_ 开头,由 Growth Studio 后台生成并绑定到指定账号和工作空间。
所有请求必须携带:
Authorization: Bearer <API_KEY>
示例: