Получить файл

Возвращает метаданные файла по ID файла.

GET https://api.odirouter.ai/v1/files/{file_id}

Параметры пути

curl --location "https://api.odirouter.ai/v1/files/file_456" \
  --header "Authorization: Bearer YOUR_API_KEY"

file_id string обязательно

ID файла, например file_456

Параметры ответа

{
  "id": "file_456",
  "object": "file",
  "filename": "reference.png",
  "bytes": 345678,
  "mime_type": "image/png",
  "file_type": "image",
  "source": "upload",
  "dimensions": {
    "width": 1024,
    "height": 768
  },
  "storage_policy": "temporary",
  "created_at": 1784256000,
  "expires_at": 1784860800,
  "url": "https://private.cdn.odirouter.ai/uploads/xxx.png?Expires=..."
}

Поле	Тип	Описание
id	string	ID файла в формате file_{id}
object	string	Всегда file
filename	string	Исходное имя файла; если имя не передано, его генерирует платформа
bytes	integer	Размер файла в байтах
mime_type	string	MIME-тип файла
file_type	string	Тип файла. Возможные значения в ответе: image, audio, video, document, text
source	string	Источник файла. Возможные значения в ответе: upload и api. upload означает, что файл создан через API загрузки файлов, а api означает, что файл сгенерирован другим API-вызовом и поддерживается платформой
dimensions	object | null	Размеры файла. Для JPEG, PNG и GIF возвращается ширина и высота; для остальных файлов или неподдерживаемых форматов изображений возвращается null
dimensions.width	integer	Ширина в пикселях; возвращается только если dimensions не равен null
dimensions.height	integer	Высота в пикселях; возвращается только если dimensions не равен null
storage_policy	string	Политика хранения. Сейчас всегда temporary
created_at	integer	Время создания, Unix timestamp в секундах
expires_at	integer	Время истечения, Unix timestamp в секундах. В текущей версии у всех файлов есть конкретное время истечения
url	string	Текущий доступный краткоживущий подписанный URL

Удаленные, истекшие или недоступные файлы нельзя получить. При запросе таких файлов API возвращает 404 file_not_found.