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

Загружает файл для дальнейшего использования в других запросах

Параметры
Расширенный вызов ?

Функция ЗагрузитьФайл(Знач URL, Знач Токен, Знач ИмяФайла, Знач Данные, Знач Назначение, Знач ДопЗаголовки = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
URL	--url	Строка	✔	URL сервера OpenAI
Токен	--token	Строка	✔	Токен авторизации OpenAI
ИмяФайла	--name	Строка	✔	Имя файла с расширением
Данные	--data	Строка, ДвоичныеДанные	✔	Путь к файлу или данные
Назначение	--purpose	Строка	✔	Назначение файла: assistants, batch, vision, user_data, evals
ДопЗаголовки	--headers	Соответствие Из КлючИЗначение	✖	Доп. заголовки запроса, если необходимо

Возвращаемое значение

Соответствие Из КлючИЗначение - Результат обработки

Параметр	Описание
proxy	`ИнтернетПрокси` или структура полей `Протокол`, `Сервер`, `Порт`, `Пользователь`, `Пароль`, `ИспользоватьАутентификациюОС`
timeout	Таймаут выполнения запроса
adv_response	Оформляет ответ в виде полной структуры HTTP-ответа с полями `code`, `body` и `headers`
retries	Число попыток отправки HTTP-запроса при коде `5**` или внутренних ошибках клиента
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

подсказка

Метод в документации API: Upload file

Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL

Пример использования для 1С:Предприятие/OneScript
    URL   = "https://hut.openintegrations.dev/localai/";
    Токен = "12We34...";

    Файл = "https://releases.openintegrations.dev/test_data/picture.jpg"; // URL, Путь или Двоичные данные

    ИмяФайла   = СтрШаблон("%1.png", Строка(Новый УникальныйИдентификатор()));
    Назначение = "assistants";

    Результат = OPI_OpenAI.ЗагрузитьФайл(URL, Токен, ИмяФайла, Файл, Назначение);

Bash
CMD/Bat

    oint openai ЗагрузитьФайл \
      --url "https://hut.openintegrations.dev/localai/" \
      --token "***" \
      --name "b3b8adde-0418-4365-8184-53704f9174ad.png" \
      --data "https://releases.openintegrations.dev/test_data/picture.jpg" \
      --purpose "assistants"

    oint openai ЗагрузитьФайл ^
      --url "https://hut.openintegrations.dev/localai/" ^
      --token "***" ^
      --name "b3b8adde-0418-4365-8184-53704f9174ad.png" ^
      --data "https://releases.openintegrations.dev/test_data/picture.jpg" ^
      --purpose "assistants"

Результат
{
 "id": "file-46",
 "object": "file",
 "bytes": 2114025,
 "created_at": "2026-07-19T19:10:26.574618624Z",
 "filename": "0d016ce4-838e-439c-98a9-b96b5dd5de05.png",
 "purpose": "assistants"
}