Get File · Moss API

Request parameters

Path parameterTypeRequiredDescription

file_id: stringRequired

The id returned by POST /v1/files.

Return value

FieldTypeDescription

id: string

File id, i.e. the file_id.

object: string

Fixed as file.

bytes: integer

File size in bytes.

created_at: integer

Creation time, a Unix timestamp in seconds.

filename: string

Original filename.

purpose: string

File-purpose label; it may be an empty string.

status: string

File status, subject to the actual server response.

Boundary

The public API does not expose asset_id; when a model invocation passes a file_id, the platform resolves it into a download URL for downstream use, so both the caller and the model side only interact with file_id or a URL.

Next steps

Delete File

Delete an uploaded file.

Upload File

Upload an audio file and obtain a file_id.

Request example

curl -X GET "https://api.mosi.cn/v1/files/<file_id>" \
  -H "Authorization: Bearer $MOSS_API_KEY"

import os
import requests

response = requests.get(
        "https://api.mosi.cn/v1/files/<file_id>",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/files/<file_id>", {
  method: "GET",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
  },
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

Response example

{
  "id": "<file_id>",
  "object": "file",
  "bytes": 1048576,
  "created_at": 1710000000,
  "filename": "speech.wav",
  "status": "active"
}