Files API

OpenAI-совместимый Files API PlusVibe: POST /v1/files, чтение метаданных и содержимого, удаление. Лимит загрузки - 50 MiB.

OpenAI-совместимый Files API для загрузки, чтения и удаления файлов. Каждая операция требует API-ключ; файл доступен только тому же клиентскому аккаунту, который его загрузил.

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

POSThttps://plusvibeapi.ru/v1/files

Отправьте multipart/form-data с обязательными полями file и purpose. Допустимы purpose: assistants, batch, fine-tune, vision и user_data. Максимальный размер файла - 50 MiB (52 428 800 байт); превышение возвращает 413.

curl -X POST https://plusvibeapi.ru/v1/files \
  -H "Authorization: Bearer $PLUSVIBE_API_KEY" \
  -F "purpose=user_data" \
  -F "file=@./report.pdf"

Получить метаданные, содержимое или удалить

GEThttps://plusvibeapi.ru/v1/files/{file_id}

GEThttps://plusvibeapi.ru/v1/files/{file_id}/content

DELETEhttps://plusvibeapi.ru/v1/files/{file_id}

Upload возвращает объект file с opaque id, именем, размером, purpose и временем создания. GET без /content возвращает эти метаданные; GET /content скачивает исходные байты. После успешного DELETE оба GET возвращают 404. Чужой существующий файл возвращает 403, а неизвестный идентификатор - 404.

Безопасный workflow

Загрузите файл и сохраните только возвращённый file_id.
Проверьте метаданные тем же ключом; при работе с Responses передавайте этот ID в input_file.file_id.
Не загружайте секреты и удаляйте файл после завершения работы. Удалённый файл нельзя восстановить.

Files API не гарантирует, что любой выбранный модельный маршрут принимает файлы. Если маршрут не поддерживает файл, исправьте форму запроса или выберите совместимую модель; не заменяйте полученный file_id сторонним идентификатором.

← ПредыдущийМиграция генерации видео Следующий →Веб-поиск