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.
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.
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"
}'
| 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 |
url. Unknown fields, empty URLs, invalid JSON, and multiple JSON documents are rejected. The API key determines the account and workspace; do not supply them in the request..mp4 filename extension is not required. Signed URLs should remain valid throughout processing.HTTP status code: 200 OK
Response headers:
X-Request-Id: upload-video-001
Response body: