Growth Studio OpenAPI接入文档 · Import Videos
通过公网视频直链导入参考视频,获得当前工作空间中的 video_id,用于后续爆款复刻。
POST /openapi/v1/video/upload
Content-Type: application/json
Authorization: Bearer <API_KEY>
这是同步接口:视频获取、校验和内容审核全部成功并保存素材后,才返回 200 OK。接口不返回 run_id,无需轮询上传任务。请求体为 JSON,最大 64 KiB,不接受 multipart 文件上传。
将 url 替换为可直接下载视频的公网地址;BASE_URL 和 API Key 使用对应地区的配置:
curl --request POST \
"${BASE_URL}/openapi/v1/video/upload" \
--header "Authorization: Bearer ${API_KEY}" \
--header 'Content-Type: application/json' \
--data-raw '{
"url": "https://example.com/reference.mp4"
}'
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
url |
string | 是 | 无需 Cookie 或自定义鉴权 Header 即可访问的公网 HTTP/HTTPS 视频直链;支持带签名查询参数的 URL |
url;未知字段、空 URL、无效 JSON 或多个 JSON 文档会被拒绝。账号和工作空间由 API Key 确定,无需传入。.mp4 结尾。签名 URL 应在整个处理期间保持有效。HTTP 状态码:200 OK
响应头:
X-Request-Id: upload-video-001
响应体: