Skip to main content
POST
/
user
/
oss
Configure Alibaba OSS
curl --request POST \
  --url https://api.tornadoapi.io/user/oss \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "endpoint": "<string>",
  "bucket": "<string>",
  "access_key_id": "<string>",
  "access_key_secret": "<string>",
  "folder_prefix": "<string>",
  "base_folder": "<string>"
}
'
{
  "message": "Alibaba OSS storage configured successfully",
  "provider": "oss",
  "container_or_bucket": "tornado-downloads"
}

​
Overview

Set up Alibaba Cloud OSS for uploaded videos. Credentials are verified before saving.

​
Header Parameters

​
x-api-key
string
required
Your API key for authentication

​
Request Body

​
endpoint
string
required
OSS endpoint URL (e.g., https://oss-cn-hangzhou.aliyuncs.com)
​
bucket
string
required
OSS bucket name
​
access_key_id
string
required
OSS Access Key ID
​
access_key_secret
string
required
OSS Access Key Secret
​
folder_prefix
string
Optional folder prefix for organizing uploads (e.g., downloads/2024/)
​
base_folder
string
default:"videos"
Base folder name for uploaded files. Defaults to videos if not specified. Set to a custom value to change the top-level folder where files are stored (e.g., downloads, media).

​
Response

​
message
string
Success confirmation message
​
provider
string
Storage provider type: oss
​
container_or_bucket
string
The configured bucket name
​
folder_prefix
string
The configured folder prefix (if provided)

​
Examples

curl -X POST "https://api.tornadoapi.io/user/oss" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
    "bucket": "tornado-downloads",
    "access_key_id": "LTAI5tXXXXXXXXXXXXXX",
    "access_key_secret": "XXXXXXXXXXXXXXXXXXXXXXXXXX"
  }'

​
Success Response

{
  "message": "Alibaba OSS storage configured successfully",
  "provider": "oss",
  "container_or_bucket": "tornado-downloads"
}

​
Error Responses

{
  "error": "Credential validation failed: AccessDenied"
}

​
OSS Endpoint Regions

RegionEndpoint
China (Hangzhou)https://oss-cn-hangzhou.aliyuncs.com
China (Shanghai)https://oss-cn-shanghai.aliyuncs.com
China (Beijing)https://oss-cn-beijing.aliyuncs.com
Singaporehttps://oss-ap-southeast-1.aliyuncs.com
US Westhttps://oss-us-west-1.aliyuncs.com
Germanyhttps://oss-eu-central-1.aliyuncs.com