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 文件上传。

cURL

将 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

成功响应

HTTP 状态码:200 OK

响应头:

X-Request-Id: upload-video-001

响应体: