Growth Studio OpenAPI接入文档 · Getting Started

接口概览

本文档面向通过服务端接入 Growth Studio 视频生成能力的外部调用方。

正式环境域名由 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

正式环境 API Key 以 mh_live_ 开头,由 Growth Studio 后台生成并绑定到指定账号和工作空间。

所有请求必须携带:

Authorization: Bearer <API_KEY>

示例: