API 24AI для разработчиков: удаление и замена фона, примерка, генерация тени и другие возможности
Только собственные модели 24AI, без обращений к внешним моделям: генерация фона, удаление фона, генерация изображения, изменение пропорций, генерация тени и примерка одежды. Вызывайте методы из своего сервиса, приложения или конвейера карточек.
- Тариф «Профессиональный»: тариф, на котором работает API
- 5 запросов в секунду: публичный лимит частоты вызовов
- Ключ в кабинете: выдаётся владельцу аккаунта
- Оплата картой РФ, по СБП или по счёту: оплата по договору с юридическим лицом в РФ
API работает на тарифе «Профессиональный», на других тарифах его функционал недоступен.
24AI — сервис АО «Точка», правообладатель ООО «Архивариус»
Что API делает с изображением
API работает только с собственными моделями 24AI, обращений к внешним моделям нет: генерация фона, удаление фона, генерация изображения, изменение пропорций, генерация тени и примерка одежды. Каждый метод принимает файл или промпт и возвращает готовый кадр.
-
Создание фона для товара
Модель подставляет под товар сцену по текстовому описанию: студийная поверхность, интерьер, окружение под категорию. На вход идут фото товара и промпт, обратно приходит собранный кадр.
Фото товара и описание сцены на вход, файл до 15 МБ.
-
Удаление фона с фото
Метод отделяет предмет от фона и возвращает изображение с прозрачностью: альфа-канал сохраняется, товар дальше кладётся на любую подложку — белую, цветную или шаблон карточки.
JPG, PNG, WEBP и HEIC, до 15 МБ; на выходе — прозрачность.
-
Генерация тени
Метод подставляет под предмет тень: кадр без фона получает контактную тень и перестаёт выглядеть вырезанным. Вызовы здесь асинхронные — запрос возвращает идентификатор, а готовый кадр забирается по статусу.
Кадр исходного продукта на вход; ответ — по идентификатору запроса, партия отправляется одним вызовом.
Документация метода тени -
Изменение размера фото
Кадр приводится к нужному соотношению сторон, а фон дорисовывается за границами исходного снимка. Товар не обрезается, поэтому одно фото подходит сразу нескольким площадкам с разными требованиями.
Исходный кадр и целевые пропорции, файл до 15 МБ.
-
Виртуальная примерка
Метод показывает вещь надетой: на вход подаются снимок одежды и кадр человека, обратно приходит изображение модели в этой вещи. Съёмка на живой модели для каждой позиции не нужна.
Два файла: фото одежды и фото модели, каждый до 15 МБ.
-
Пара простых белых низких кед стоит рядом на гладком серо-бетонном полированном полу, снято строго фронтально в вертикальном кадре.
Генерация по промпту
Изображение создаётся по промпту — текстовому описанию задачи. Исходный файл не нужен: вы задаёте предмет, сцену и стиль, а модель возвращает новый кадр.
Текст промпта на вход, исходный файл загружать не нужно.
Что через API не вызывается
-
Массовая обработка до 250 изображений за загрузку, функционал доступен только в интерфейсе сервиса.
-
Визуальный редактор инфографики: слои, шаблоны и текст, функционал доступен только в интерфейсе сервиса.
-
Пайплайны из нескольких моделей нейросетей собираются в интерфейсе сервиса в разделе «Пайплайны».
-
Внешние модели нейросетей (GPT, Claude, Kling, Gemini, DeepSeek и другие) доступны только в интерфейсе сервиса, в API их нет.
Нужен программный доступ к текстовым моделям — запросите условия в поддержке: support@24ai.tech.
Где API встаёт в рабочий процесс
-
Конвейер карточек в своей системе
Фото лежат в товароучётной системе, а фон и пропорции правит менеджер вручную. Вызов встаёт между выгрузкой и отправкой на площадку: система отдаёт исходный кадр и кладёт готовый в хранилище. Ручной шаг из процесса уходит.
Схема: - Товароучётная система
- API 24AI
- Хранилище изображений
- Кабинет площадки
-
Обработка внутри вашего продукта
Пользователь вашего SaaS или мобильного приложения загружает фото и ждёт результат на том же экране. Запрос уходит с вашего бэкенда, ключ остаётся на сервере, готовый кадр возвращается в интерфейс под вашим брендом. Своя модель и её обслуживание не нужны.
Схема: - Приложение пользователя
- Ваш бэкенд
- API 24AI
- Экран с результатом
-
Автоматизация каталога по расписанию
Каталог пополняется выгрузками, часть изображений не проходит требования площадки. Скрипт по расписанию забирает новые файлы из хранилища, вызывает нужный метод и складывает результат обратно. Интерфейс для этого не нужен: всё идёт на стороне бэкенда.
Схема: - Хранилище файлов
- Планировщик задач
- API 24AI
- Выгрузка для площадки
Связка без своего кода. Интеграция подключается настройкой, API — разработкой. Напишите в поддержку, с каким сервисом нужна связка: support@24ai.tech.
Что уходит в запрос и что приходит в ответ
Выберите метод и посмотрите, что принимает вызов и что возвращает: кадры из настоящих вызовов. Запросы отсюда не отправляются — чтобы прогнать метод на своём файле, откройте его в кабинете.
Запрос
Изображениефайл
Промптстрока
Наушники на плите светлого травертина у окна. Мягкий утренний свет слева, по камню и стене падает тень от листьев монстеры, рядом стоит стакан с водой.
Ответ
Запрос
Изображениефайл
Ответ
Запрос
Изображениефайл
Адрес обратного вызовастрока
Куда прислать готовый кадр, когда обработка закончится
Идентификатор запросастрока
Свой ключ: повторный вызов с ним не создаёт второй запрос
Ответ
Запрос
Изображениефайл
Пропорциистрока
3:4
Ответ
Запрос
Фото одеждыфайл
Фото моделифайл
Ответ
Запрос
Промптстрока
Матовый чайник из нержавеющей стали на светлой кухонной столешнице, дневной свет из окна слева, на заднем плане размытые банки со специями.
Ответ
Четыре шага до первого ответа
-
Оформите тариф «Профессиональный» и получите ключ в личном кабинете: на других тарифах функционал API недоступен.
-
Держите ключ в переменной окружения на своём сервере и подставляйте в заголовок запроса, а не в код клиента.
-
Отправьте первое изображение на удаление фона: в минимальном запросе нужны только файл и ключ.
-
Проверьте код ответа, сохраните файл результата и сверьте списание в истории генераций кабинета.
Контракт вызова: что отправляете и что получаете
Спроектируйте интеграцию до получения ключа: ниже собраны параметры каждого метода и структура ответа.
| Параметр | Тип | Обязателен | Описание | |
|---|---|---|---|---|
| Создание фона | Изображение | файл | да | Фото товара: JPG, PNG, WEBP или HEIC, до 15 МБ |
| Промпт | строка | да | Описание сцены: поверхность, окружение, свет | |
| Удаление фона | Изображение | файл | да | Кадр, из которого вырезается предмет |
| Генерация тени | Изображение | файл | да | Кадр продукта: отдельные методы принимают файл и ссылку на него |
| Адрес обратного вызова | строка | нет | Куда прислать готовый кадр, когда обработка закончится | |
| Идентификатор запроса | строка | нет | Свой ключ: повторный вызов с ним не создаёт второй запрос | |
| Изменение размера | Изображение | файл | да | Исходный кадр без обрезки товара |
| Пропорции | строка | да | Соотношение сторон результата, например 3:4 | |
| Примерка одежды | Фото одежды | файл | да | Снимок вещи, которую показывают на модели |
| Фото модели | файл | да | Кадр человека, на котором показывают вещь | |
| Генерация по промпту | Промпт | строка | да | Описание предмета, сцены и стиля кадра |
Создание изображения занимает от 30 до 60 секунд: время зависит от размера кадра и соединения. Точные имена методов и параметров — в справочнике документации.
Коды ответа и повторные отправки
| Код | Что произошло | Что делать |
|---|---|---|
| 401 | Ключ не передан или неверен | Подставьте ключ из кабинета |
| 403 | Тариф не даёт доступа к API | Оформите «Профессиональный» |
| 413 | Файл больше 15 МБ по размеру | Сожмите изображение до 15 МБ |
| 415 | Формат файла не поддержан | Переведите файл в JPG или PNG |
| 429 | Больше 5 запросов в секунду | Выдержите паузу из заголовка |
| 500 | Сбой на стороне сервиса | Повторите вызов и сообщите в поддержку |
Повторная отправка после кода 429. Вызов API списывает операции, а на «Профессиональном» операции не ограничены. Списания по каждому вызову видны в истории генераций в кабинете.
Лимиты, от которых считают пропускную способность
-
5 запросов в секунду Частота вызовов
Публичный лимит на отправку. Пики держите очередью на своей стороне.
-
15 МБ Размер изображения
Предел одного входного файла. Тяжёлые кадры сжимайте до вызова.
-
4 формата Форматы загрузки
JPG, PNG, WEBP и HEIC. Остальное конвертируйте заранее.
-
30–60 секунд Время генерации
Столько готовится один кадр. Отсюда считается срок на каталог.
Что происходит при превышении лимита
Вызовы сверх пяти в секунду возвращают код 429 и не выполняются: файл не обрабатывается, результат не создаётся. В ответе приходят заголовки с оставшимся лимитом и паузой до следующей попытки. Повтор отправляйте по этому значению — фиксированный интервал в коде либо растягивает обработку, либо снова упирается в лимит.
Держите отправку ниже порога на своей стороне. Очередь с равномерным темпом проходит быстрее пачки вызовов с повторами после отказов, а время на каталог считается от пяти вызовов в секунду с запасом на ошибки сети. Разовые прогоны большого объёма переносите на ночное окно, чтобы они не конкурировали с дневными задачами сервиса.
Сколько стоит доступ к API
API входит в тариф «Профессиональный»: подписка с включённым объёмом, а не оплата за каждый вызов по факту.
- Тариф «Профессиональный» даёт безлимитные операции, 3 500 токенов и до трёх пользователей в аккаунте.
- Токены расходуются на запросы к внешним нейросетям, операции — за обращения к собственным моделям 24AI.
- Неизрасходованные токены лежат на балансе 6 месяцев после окончания оплаченного тарифа, использованные не возвращаются.
Сколько времени займёт ваш объём
Расчёт объёма — по запросу
Профессиональный
3 999 ₽ в месяц
- Доступ к API и ключ в личном кабинете
- Безлимитные операции в инструментах 24AI
- Пакет из 3 500 токенов на генерации
- Командный аккаунт на трёх пользователей
Оплата картой РФ, зарубежной картой или через СБП.
Права на результат и договор
Исключительные права на сгенерированные материалы принадлежат владельцу аккаунта. Изображения, полученные через API, публикуются без ограничений: в карточках товаров на маркетплейсах, в рекламе и в коммерческих материалах. Отдельное разрешение на коммерческое использование результата запрашивать не нужно.
На саму программу для ЭВМ пользователь получает простую неисключительную лицензию — право работать с сервисом, а не владеть им. Ответственность за законность контента остаётся на владельце аккаунта: права на исходные снимки и соответствие публикаций требованиям площадок проверяете вы.
Лицензиар: ООО «Архивариус» · ИНН 5408024261 · ОГРН 1195476051891. Аккредитованная ИТ-компания. Владелец сервиса — АО «Точка» с октября 2024 года.
- Оферта и условия использования (PDF)
- Политика конфиденциальности (PDF)
- Прайс-лист программы 24AI (PDF)
Хранение и удаление загруженных файлов
Порядок работы с загруженными материалами описан в политике конфиденциальности — это действующий документ сервиса, а не строка на странице. В нём зафиксировано, какие данные 24AI собирает и как с ними обращается. Действующая версия лежит на app.24ai.tech, ссылка — в конце подблока.
Срок хранения загруженных файлов и результатов, порядок удаления по запросу, использование материалов для обучения моделей, передачу данных внешним поставщикам моделей и возможность соглашения об обработке персональных данных подтверждает поддержка. Запросите ответ по вашему сценарию до подключения: support@24ai.tech.
Что выбирают вместо API 24AI
Сравнение по классам решений, между которыми выбирает команда перед запуском обработки изображений.
| Критерий | API 24AI | Зарубежный API | Своя модель | Ручная работа |
|---|---|---|---|---|
| Оплата | Рубли: карта РФ, зарубежная карта, СБП | Валютная карта или иностранное юридическое лицо | Счета за серверы и GPU, часто в валюте | Оплата исполнителю по договору или сдельно |
| Договор | Лицензия от ООО «Архивариус», юридическое лицо в РФ | Договор с иностранным поставщиком | Договоры с хостингом и своей командой | Договор подряда или трудовой договор |
| Доступ | Из России без VPN и зарубежной карты | Часто нужен VPN и валютная карта | Зависит от размещения серверов | Доступ не зависит от сервисов |
| Тарификация | Подписка с включённым объёмом | Оплата за каждый вызов по факту | Постоянная плата за инфраструктуру | Оплата за каждое изображение |
| Что потребуется для старта | Оформление тарифа и ключ в кабинете | Регистрация, ключ, валютный платёж | Обучение, GPU, инженеры поддержки | Поиск исполнителя и тестовое задание |
| Маркетплейсы | Фон, примерка, пропорции под площадки | Базовая обработка без учёта площадок | Только то, чему обучили модель | Любые задачи, но по одному файлу |
| Запуск | Вызов сразу после оформления тарифа | Регистрация, ключ, валютный платёж | Сбор данных, обучение, тестирование | Зависит от загрузки исполнителя |
Когда API 24AI не подойдёт
Подписка проигрывает поштучной оплате на малых объёмах: при нескольких десятках изображений в месяц фиксированный тариф дороже оплаты за вызов у другого поставщика. Ключ выдаётся только на старшем тарифе, поэтому дешёвого входа ради одного теста нет. Публичный лимит в 5 запросов в секунду ограничивает пик: тысячу файлов за минуту обработать не выйдет, объём придётся растягивать очередью.
Документация, сообщество и поддержка
-
Справочник методов
Документация описывает методы, параметры вызова, коды ошибок и рабочие примеры запросов. Там же публикуются изменения методов. Асинхронные методы — генерация тени — описаны отдельной спекой «Shadow Async API».
-
Канал сообщества
Telegram-канал @app_24ai_tech — обновления сервиса, разборы новых моделей и вопросы других пользователей 24AI.
-
Поддержка по почте
Поддержка отвечает на support@24ai.tech и в виджете кабинета: доступы, техника интеграции, вопросы по списаниям.
Разбор идёт быстрее, если в обращении есть идентификатор запроса, время вызова, метод, код ответа и его тело.
Вопросы разработчиков об API
Почему API доступен только на «Профессиональном»?
Ключ выдаётся на этом тарифе, «Пробный», «Стартовый» и «Базовый» вызовы не открывают. «Профессиональный» собран под команды: безлимитные операции, 3 500 токенов и до трёх пользователей в аккаунте. Доступ к API входит в этот пакет и отдельно не оплачивается.
Можно ли протестировать API до оплаты тарифа?
Пробного доступа к ключу нет: ключ выдаётся только на «Профессиональном», а «Пробный», «Стартовый» и «Базовый» вызовы не открывают. Проверить сами функции можно до оплаты — в интерфейсе 24AI работают те же методы, что и в API: генерация и удаление фона, генерация изображения, изменение пропорций, генерация тени и примерка одежды. Прогоните их на своих файлах в кабинете, а параметры вызова, коды ошибок и примеры запросов посмотрите в документации. Блок проверки на этой странице показывает, что уходит на вход и что возвращается, но запросы из него не отправляются.
Списывается ли тарифная единица при ошибке вызова?
Вызов API списывает операции, а на «Профессиональном» операции не ограничены. Списания по каждому вызову видны в истории генераций в кабинете.
Что происходит при превышении 5 запросов в секунду?
Лишние вызовы возвращают код 429 и не выполняются: файл не обрабатывается, списания за него нет. В ответе приходят заголовки с оставшимся лимитом и паузой до следующей попытки. Повтор стройте на этом значении, а не на фиксированной задержке в коде.
Можно ли продавать обработанные изображения клиентам?
Да. Исключительные права на сгенерированные материалы принадлежат владельцу аккаунта, использовать их можно без ограничений — в карточках на маркетплейсах, в рекламе и в коммерческих материалах. Если вы обрабатываете изображения для клиентов своего сервиса, условия передачи результата закрепите в собственном договоре с ними.
Чьи права на результат, если файл загрузил мой пользователь?
Права на результат принадлежат владельцу аккаунта 24AI, то есть вашей компании, пока вызовы идут по вашему ключу. Ответственность за законность контента лежит на владельце аккаунта: проверяйте, что у пользователей есть права на исходные снимки. Дальнейшую передачу прав вашим клиентам описывайте в своей оферте.
Нужны ли VPN и зарубежная карта для работы с API?
Нет. Сервис работает из России без VPN, тариф оплачивается картой РФ, зарубежной картой или через СБП. Договор заключается с российским юридическим лицом — ООО «Архивариус», ИНН 5408024261.
Будет ли API работать из-за пределов России?
Да, вызовы идут из любой страны: и кабинет, и публичный API работают через интернет без привязки к региону.
Где выдаётся ключ и как его заменить?
Ключ выдаётся владельцу аккаунта в личном кабинете, там же ведётся работа с доступами. При необходимости ключ можно заменить на новый в личном кабинете 24AI во вкладке «API». Держите ключ в переменной окружения на сервере и не публикуйте его в клиентском коде.
Доступны ли через API текстовые модели и видео?
API работает только с собственными моделями 24AI, обращений к внешним моделям нет: генерация фона, удаление фона, генерация изображения, изменение пропорций, генерация тени и примерка одежды выполняются на собственных моделях 24AI. Модели внешних провайдеров — GPT, Claude, Gemini, DeepSeek, Kling, Seedance и другие — доступны в разделе «Нейросети» в сервисе 24AI. Нужен программный вызов этих моделей — запросите условия в поддержке.
Что делать, если разработчика нет
API — это интерфейс, через который одна программа вызывает другую. Если подключать его некому, те же задачи закрываются в кабинете.
-
Обработка без кода
Загрузите до 250 изображений за раз, уберите фон и соберите карточку по слоям в редакторе с шаблонами.
-
Цепочка без разработки
Соедините несколько нейросетей в пайплайн: запуск товара на площадке, карточка под ключ, контент для соцсетей.
-
Модели в интерфейсе
Работайте с GPT, Claude, Gemini, Grok, DeepSeek, FLUX, Veo и Kling в одном окне в режиме чата с общим балансом токенов для всех моделей.
