To process files and save the results:
Create a file transformation URL (see ProcessFile docs).
Test the file transformation URL (with GET).
Add /save to the URL (after your account ID).
Submit a POST request to the URL (with the request body described below).
Tip: you can use ProcessFile to use GET requests instead. You can leverage Bytescale's permanent caching to ensure each URL is only processed once, no matter how many times it is requested.
1curl "https://upcdn.io/{accountId}/save/{transformation}/{filePath}{?params}" \2 -H "Authorization: Bearer YOUR_API_KEY" \3 -H "Content-Type: application/json" \4 -d @- << EOF5 {6 "destination": {7 "fileName": "example-{UNIQUE_DIGITS_4}{ORIGINAL_FILE_EXT}"8 }9 }10EOF
1{2 "async": false,3 "accountId": "A623uY2",4 "filePath": "/my-processed-image.jpg",5 "fileUrl": "https://upcdn.io/A623uY2/raw/my-processed-image.jpg"6}
Your account ID.
This is visible on the settings page:
https://www.bytescale.com/dashboard/settings
Example: A623uY2
Type: String
Length: 7
In: Path
Required: Yes
Absolute path to a file. Begins with a /.
Example: /uploads/image.jpg
Type: String
Min Length: 1
Max Length: 512
In: Path
Required: Yes
The name of the File Processing API (e.g. "image", "video", "audio") or transformation preset (created in the Bytescale Dashboard) to use when processing the file.
Example: thumbnail
Type: String
Min Length: 1
Max Length: 100
In: Path
Required: Yes
Parameters to submit to the File Processing API (e.g. the Image Processing API).
Please see the documentation for each File Processing API to determine which values can appear here:
•https://www.bytescale.com/docs/image-processing-api
•https://www.bytescale.com/docs/video-processing-api
•https://www.bytescale.com/docs/audio-processing-api
•https://www.bytescale.com/docs/archive-processing-api
Type: Object
In: Querystring
Required: No
Add one of these Authorization header values to your request:
•Option 1: prefix "Bearer " to your API key. The result is your Authorization header value.
•Option 2: use HTTP basic authorization, specifying apikey as your username, and your API key as your password.
Type: String
In: Header
Required: Yes
This endpoints requires a JSON request body.
Type: String
Value: "application/json"
In: Header
Required: Yes
This website uses cookies. By continuing you are consenting to the use of cookies per our cookie policy.
This website requires a modern web browser -- the latest versions of these browsers are supported: