Growth Studio OpenAPI Integration Guide · 导入视频

Import a reference video from a public URL to obtain a video_id in the current workspace for subsequent Viral Clone requests.

Request

POST /openapi/v1/video/upload
Content-Type: application/json
Authorization: Bearer <API_KEY>

This endpoint is synchronous: it returns 200 OK only after the video has been retrieved, validated, approved by content moderation, and saved. It does not return a run_id; there is no upload task to poll. The request body must be JSON, with a maximum size of 64 KiB. Multipart file uploads are not supported.

cURL

Replace url with a public direct download URL for the video. Use the BASE_URL and API key for the appropriate region:

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"
  }'

Request Parameters and Video Requirements

Field Type Required Description
url string Yes Public HTTP/HTTPS direct video URL that requires no cookies or custom authentication headers; signed query parameters are supported

Successful Response

HTTP status code: 200 OK

Response headers:

X-Request-Id: upload-video-001

Response body: