Retrieve File

curl --request GET \
  --url https://api.minimax.io/v1/files/retrieve \
  --header 'Authorization: Bearer <token>'

{
  "file": {
    "file_id": "${file_id}",
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "output_aigc.mp4",
    "purpose": "video_generation",
    "download_url": "www.downloadurl.com"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

GET

files

retrieve

Retrieve File

curl --request GET \
  --url https://api.minimax.io/v1/files/retrieve \
  --header 'Authorization: Bearer <token>'

{
  "file": {
    "file_id": "${file_id}",
    "bytes": 5896337,
    "created_at": 1700469398,
    "filename": "output_aigc.mp4",
    "purpose": "video_generation",
    "download_url": "www.downloadurl.com"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorizations

Authorization

string

header

required

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key, can be found in Account Management>API Keys.

Query Parameters

file_id

integer<int64>

required

The unique identifier for the file. Supports file_id obtained from video generation and asynchronous speech synthesis tasks.

Response

200 - application/json

file

object

Show child attributes

file.file_id

integer<int64>

The unique identifier for the file.

file.bytes

integer<int64>

The size of the file in bytes.

file.created_at

integer<int64>

The Unix timestamp (in seconds) when the file was created.

file.filename

string

The name of the file.

file.purpose

string

The purpose of the file.

base_resp

object

Show child attributes

base_resp.status_code

integer

The status codes are as follows:

1000, Unknown error;
1001, Timeout;
1002, RPM limit triggered;
1004, Authentication failed;
1008, Insufficient balance;
1013, Internal service error;
1026, Input content error;
1027, Output content error;
1039, TPM limit triggered;
2013, Abnormal input format.

For more information, please refer to the Error Code Reference.

base_resp.status_msg

string

Status details.

List Retrieve File Content

Text

Speech

Video

Image

Music

File

Error Code

Retrieve File

Authorizations

Query Parameters

Response