Save URL to A2E's storage

Transfer and Store External Link Content in A2E’s Object Storage

When creating an avatar using the POST /api/v1/userVideoTwin/startTraining API, you must provide a video file URL. For privacy reasons, we do not automatically store the content of your URL in our storage. Instead, each time you generate an AI avatar video via POST /api/v1/video/generate, our system retrieves the video directly from the provided URL.

However, if your URL is slow to access or not permanent, AI video generation may fail. To optimize performance and ensure reliability, you can use this API endpoint to store the content in A2E’s object storage. By doing so, algorithmic processing speed is significantly improved due to reduced network latency and optimized data retrieval.

This is particularly useful when:

Your video content is temporary and cannot be directly used with /api/v1/userVideoTwin/startTraining.

The connection to your URL is slow or unstable. Transferring the file to A2E storage accelerates subsequent processing.
Note: The maximum supported size is 5 GiB. Objects larger than 5 GiB will fail to be fetched.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

url

string

required

An external link you wan to Transfers and stores

Example

{
    "url": "https://example.com/fa/stable/9e7525302bb7185bdd0d6f950cbb76838d06d64a062bbfe8f8aaf80a355a808e.mp3"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

code

integer

required

0 is OK

data

object

required

url

string

required

trace_id

string

required

Example

{
    "code": 0,
    "data": {
        "url": "https://prod-tos.avatar2everyone.com/adam2eve/stable/users/665da3d7bcf6aba2adfdfs11/transferToStorage/e596144c-dd0c-4df2-9b75-124f24f7ec7c.mp4"
    },
    "trace_id": "c1b5c268-25bd-4627-88e9-4b23f7c7d4aa"
}