yandex

SAM 3.1 Image API

starstarstarstarstar

5/5

SAM 3.1 — нейросеть, которая выделяет объекты на изображении и возвращает маски для дальнейшего редактирования и автоматической обработки.

ID для подключения по API : sam-3-1-image

Средняя скорость генерации ~ 8.20 сек
Дата выхода: 29/04/2026

Изображения

Редактирование

Маски

Удаление фона

Бюджетная

Запустить через API
SoTA

Выберите язык:

Как работать с SAM 3.1 Image через API?

Получение API ключа

Для начала получите ваш API ключ в личном кабинете, если ещё не сделали этого.

Это ваш API-ключ с помощью, которого вы можете генерировать. Не сообщайте его никому.

Запрос на выполнение задачи

Теперь необходимо создать задачу на генерацию. Результат вы можете получать по-разному, можно по системе Long-Pooling, либо вы можете задать callback_url и мы отправим вам результат по готовности. Подробнее с тем, как использовать эти способы можете ознакомиться в документации. В данном примере мы рассмотрим способ с получением результата на callback_url.

В этом запросе указаны лишь обязательные параметры, если вам необходимы дополнительные параметры, то можете ознакомится с ними здесь

Пример ответа

Получение результата

На указанный в первом запросе callback_url придёт следующий ответ.

Ознакомиться с другими способами получения результата можете в документации

Параметры для генерации

callback_urlurl

Это URL, на который будет отправлен ответ от нейросети.

translate_inputboolean

Перевод входных данных.

Значение по умолчанию : true

is_syncboolean

Выбор режима выполнения запроса: синхронно или асинхронно.

Значение по умолчанию : false

promptstring

Обязательно

Промпт.

Значение по умолчанию : Машина

image_urlurl_or_file

Обязательно

Изображение.

apply_maskboolean

Применить маску.

Значение по умолчанию : true

output_formatstring

Формат изображения.

Значение по умолчанию : png