Skip to main content
GET
Метаданные файла
Возвращает метаданные одного файла и публичную ссылку на него. Сами байты здесь не отдаются — забирайте их по полю url.

Пример

Ответ

200 OK:

Как получить сам файл

Этот эндпоинт отдаёт только метаданные. Отдельных маршрутов /content и /download у /api/v1/storage/{id} нет — ни такого ответа на скачивание, ни переадресации.
Байты лежат по полю url:
cURL
Ссылка публичная и бессрочная. Если нужен файл в виде ответа со своими заголовками, скачайте файл сами и отдайте своим клиентам.

Чужие файлы

Файл, принадлежащий другому пользователю, возвращает 404, а не 403. Это сделано намеренно: по коду ответа нельзя определить, что идентификатор существует, но принадлежит кому-то другому.

Ошибки

Формат тела ошибки здесь такой же, как у остальных эндпоинтов хранилища: {"error": {"message": "...", "type": "invalid_request"}} — без полей param и code, которые есть у OpenAI-формата. Подробности — на странице Ошибки.

Что дальше

Список файлов

Что уже лежит в хранилище

Удалить файл

Убрать файл из хранилища

Загрузить файл

Положить файл в хранилище

Ошибки

Полная таблица кодов

Авторизации

Authorization
string
header
обязательно

API-ключ в формате sk-.... Альтернативно — заголовок X-Api-Key: sk-... (совместимо с Anthropic SDK).

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

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

Ответ

Метаданные файла.

asset
object
обязательно