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

Обновлено 4 октября 2024

Скачать спецификацию

POST

/files

Загружает в хранилище файл изображения. Возвращает объект с данными загруженного файла. Загруженные файлы доступны только вам.

Максимальный размер одного файла — 15 Мб. Максимальный размер запроса — 20 Мб.

Идентификатор файла, указанный в поле id, можно использовать при запросах на генерацию. Для этого идентификаторы нужно передать в массиве attachments. Подробнее — в разделе Генерация с помощью файлов изображений.

Поддерживаемые форматы изображений:

Формат	MIME-тип
jpg	image/jpg
png	image/png
tiff	image/tiff
bmp	image/bmp

Запрос

• multipart/form-data

Body

required

file

binary

required

Загружаемый объект

purpose

string

required

Возможные значения: [general]

По умолчанию: general

Назначение загружаемого файла

Ответы

• 200

OK

• application/json

• Схема
• Пример из схемы

Schema

bytes

integer

required

Размер файла в байтах

created_at

integer

required

Время создания файла в формате Unix-time

filename

string

required

Название файла

id

uuidv4

required

Возможные значения: Value must match regular expression (([0-9a-fA-F-])36)

Идентификатор файла, который можно использовать при запросах на генерацию. Для этого идентификаторы нужно передать в массиве attachments.

Подробнее — в разделе Генерация с помощью файлов изображений.

object

string

required

Тип объекта

purpose

string

required

Возможные значения: [general]

Назначение файлов. Значение general указывает на то, что файлы могут использоваться для генерации ответа модели

access_policy
string
Возможные значения: [public, private]
По умолчанию: private
Доступность файла возможные значения:
• public;
• private.

{
  "bytes": 120000,
  "created_at": 1677610602,
  "filename": "file123",
  "id": "6f0b1291-c7f3-43c6-bb2e-9f3efb2dc98e",
  "object": "file",
  "purpose": "general",
  "access_policy": "private"
}

Loading...

Loading...