Get R2 Upload Presigned URL

Global Server

https://video.a2e.ai

POST

/api/v1/r2/get_upload_presigned_url

Call this API to obtain a presigned URL

Use the received uploadUrl to upload the file via an HTTP PUT request

After successful upload, the file will be stored in the specified R2 bucket at the path indicated by data.key

Notes

This API consumes 1 coin from the user's balance

The presigned URL is valid for 300 seconds by default; a new URL must be requested after expiration

Uploaded files are stored in the user's dedicated directory: environment/userId/storage/filename

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "bucket": "3days-apac",
    "key": "path/test.mp4"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://video.a2e.ai/api/v1/r2/get_upload_presigned_url' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bucket": "3days-apac",
    "key": "path/test.mp4"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "code": 0,
    "data": {
        "uploadUrl": "https://3days-apac.249f5378ffb8a0786e403d44c62e5459.r2.cloudflarestorage.com/adam2eve/stable/user/63902e163a940402e1233771/path/test.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=774ea6b5cfe6a35a7bfa721eee24b0a5%2F20260104%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20260104T124623Z&X-Amz-Expires=300&X-Amz-Signature=e3edf97c868d4209d583edacd75a51d568691740a1ad9cb0a4025bdbdf9f8fba&X-Amz-SignedHeaders=host&x-amz-checksum-crc32=AAAAAA%3D%3D&x-amz-sdk-checksum-algorithm=CRC32&x-id=PutObject",
        "key": "adam2eve/stable/user/63902e163a940402e1233771/path/test.mp4",
        "bucket": "3days-apac",
        "expiresIn": 300
    },
    "trace_id": "a0f8dc1d-edf1-43bf-a820-59782dfa6d88"
}

Modified at 2026-01-04 12:45:21

Add Watermark to Video or Image

Start Text-to-Image

Get R2 Upload Presigned URL

Notes#

Request

Request Code Samples

Responses

Notes