# Шедеврум API — официальный доступ или только приложение: как убрать app-зависимость из архитектуры

Source: https://provod.ai/ru/blog/api150-a130-shedevrum

Потребительское приложение может вдохновить функцию, но не обязано быть её технической зависимостью. Если в плане image-сценария появилась строчка «дёргаем Шедеврум за картинками», её нужно вычеркнуть до того, как она превратится в backend-контракт, который нельзя воспроизводимо вызвать.

Короткий ответ на вопрос, ради которого команда сюда пришла: у самого Шедеврума нет документированного API. [Официальная страница поддержки Яндекса](https://yandex.ru/support/shedevrum/ru/) на 2026-07-18 описывает Шедеврум только как конечный продукт (установка, использование, генерация изображений, видео и текста) и не содержит ни одного упоминания программного доступа или интеграции для разработчиков. Это подтверждённый факт отсутствия, а не пробел в поиске.

Дальше вся статья о том, как из этого факта сделать архитектурное решение, а не тупик. Мы протрассируем пользовательский результат до обязательного backend-свойства, сверим его с реально документированной поверхностью и получим одно из трёх: сохранить зависимость, заменить её или исключить. Если для явно сформулированного модельного шага нужен просто подтверждённый API-маршрут, им может быть облачная поверхность Яндекса или, для части сценариев, любой другой документированный маршрут. Это отдельный маршрут доступа, а не превращение Шедеврума в backend-компонент.

[Платите в рублях за AI-модели без наценки на токены через provod.ai](/ru)

## Почему вопрос «есть ли у Шедеврума API» задан неверно?

Спорный дефолт, с которым команды приходят в дизайн-ревью: потребительское image-приложение принимают за backend-компонент. Кто-то показал на демо красивую картинку из Шедеврума, требование записали как «интегрировать Шедеврум», и теперь архитектура держится на поверхности, у которой нет контракта.

Первый вопрос должен звучать иначе: какое проверяемое свойство backend должна давать эта функция? Пользователю всё равно, какой сервис нарисовал картинку. А вот продукту не всё равно: ему нужен эндпоинт, аутентификация, предсказуемый формат ответа и право на коммерческое использование. Приложение из App Store ни одного из этих свойств не гарантирует.

Лицензионное соглашение здесь ставит жёсткую границу. [Мобильное соглашение Шедеврума](https://yandex.ru/legal/shedevrum_mobile_agreement/en/?lang=en) прямо ограничивает использование программы личными некоммерческими целями («for personal non-profit purposes»), не содержит положений об API или правах на интеграцию для разработчиков и запрещает декомпиляцию и создание производных продуктов без письменного согласия Яндекса. Технический обход интерфейса приложения нарушает эти условия, а не создаёт серую зону, на которую можно закладывать продакшн.

Поэтому у поискового запроса «api шедеврум» есть только один документированный ответ, и он отрицательный: у приложения программного контура нет. Это стоит держать как тестовый вход для бэклога, а не как обещание фичи: любая заявка с такой формулировкой должна упираться в проверку статуса поверхности, а не в чью-то память о демо.

## Что на самом деле открыл Яндекс?

Есть важная развилка, которую путают чаще всего. Нейросеть YandexART, лежащая в основе Шедеврума, была официально открыта Яндексом как отдельный API в облачном сервисе Yandex Cloud Foundation Models: [в корпоративном блоге на Habr](https://habr.com/ru/companies/yandex/articles/805745/) прямо сказано, что модель «лежит в основе приложения Шедеврум». Значит, Шедеврум и YandexART API относятся к одному модельному слою, но остаются разными поверхностями, а не одним и тем же.

Программный контур есть именно у второй поверхности. По [документации Yandex Cloud / AI Studio](https://aistudio.yandex.ru/docs/en/ai-studio/operations/generation/yandexart-request.html) вызов YandexART оформлен как POST-запрос на эндпоинт `foundationModels/v1/imageGenerationAsync` с указанием `modelUri` в формате `art://<folder_ID>/yandex-art/latest`. Уже из формы контракта видно, что нужен Yandex Cloud folder ID, которого у потребительского приложения просто не существует. [Официальный SDK Yandex Cloud](https://github.com/yandex-cloud/yandex-ai-studio-sdk) (`yandex-ai-studio-sdk`) подтверждает то же самое: для программной работы с YandexART обязательна аутентификация (API-ключ, IAM-токен, OAuth-токен или CLI) и указание folder ID.

Этот же контракт независимо подтверждён вне официальной документации. [Практический разбор на Habr](https://habr.com/ru/articles/838354/) описывает те же архитектурные детали: эндпоинт `llm.api.cloud.yandex.net/foundationModels/v1/imageGenerationAsync`, обязательный заголовок `Authorization: Api-key <ключ>` и асинхронный паттерн «запрос генерации, затем опрос статуса операции». Два независимых источника, сходящихся на одном контракте, снижают риск, что мы опираемся на опечатку в одном документе.

![Диаграмма: YandexART как модель расходится на приложение Шедеврум без API и облачный YandexART API с полным контрактом](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/02-276.png)

## Как выглядит трассировка требования?

Теперь соберём авторский инструмент этой статьи: requirements-trace. Идея простая: каждую строчку «нам нужен Шедеврум» разложить на пять колонок и не двигаться дальше, пока в строке нет подтверждённой поверхности. Оговоримся честно: сами обязательные свойства (синхронность, конкретный SLA, конкретная версия модели) источники не задают: это иллюстративная часть трассировки, которую под свой продукт заполняет команда. Проверенный факт здесь только один: статус поверхностей.

Трассировка работает в режиме fail-closed. Если обязательное backend-свойство не связано с документированной поверхностью, зависимость не остаётся «на потом», а исключается или заменяется прямо в этой строке. Это дороже на этапе дизайна и дешевле на этапе, когда фича уже в backend-плане.

| Пользовательский результат | Обязательное backend-свойство | Подтверждённая поверхность | Пробел | Решение |
| --- | --- | --- | --- | --- |
| «Картинка как в Шедевруме» | Программный эндпоинт с аутентификацией | Шедеврум: нет (S1, S2) | Нет контракта вообще | Исключить app-зависимость |
| Генерация изображения по промпту | POST + API-ключ + folder ID | YandexART в AI Studio (S4-S8) | Нужен Yandex Cloud аккаунт | Заменить на YandexART API |
| Ответ за один синхронный вызов | Синхронный ответ | YandexART: async, генерация -> опрос (S5) | Модель асинхронна | Переспроектировать под async или заменить модель |
| Коммерческое использование | Право на прод | Лицензия Шедеврума: только личное некоммерческое (S2) | Прямой запрет | Исключить app-зависимость |
| Стабильный вызов image-шага | Маршрут, переживающий сбой канала | Документированный API-маршрут | Один upstream = один канал | Заменить на маршрут с резервированием |

Прочти таблицу как машину принятия решений. Как только в колонке «Подтверждённая поверхность» стоит «Шедеврум», строка обязана закончиться исключением: у приложения нет ни эндпоинта, ни права на коммерческий вызов. Замена появляется там, где обязательное свойство ложится на документированный контракт YandexART или на другой API-маршрут.

![Таймлайн асинхронного вызова YandexART: POST на генерацию, получение operation id, опрос статуса, готовое изображение](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/03-276.png)

## Как выглядит вызов, у которого есть контракт?

Чтобы разница «приложение против API» перестала быть абстрактной, посмотри на форму реального вызова. Метод [`ImageGenerationAsync.Generate`](https://aistudio.yandex.ru/docs/en/ai-studio/image-generation/api-ref/ImageGenerationAsync/generate.html) задокументирован в официальном API-справочнике как асинхронная операция: сначала отправляется запрос на генерацию, а затем отдельный запрос на получение результата, и по документации операция может занимать от секунд до часов. Это меняет backend: синхронного «дай картинку сейчас» здесь нет, нужен опрос статуса.

Ниже показан минимальный контур запроса к YandexART по документированному контракту. Он показывает ровно то, чего нет у приложения: явный эндпоинт, заголовок аутентификации и `modelUri` с folder ID.

```bash
curl -X POST \
  https://llm.api.cloud.yandex.net/foundationModels/v1/imageGenerationAsync \
  -H "Authorization: Api-key ${YANDEX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "modelUri": "art://<folder_ID>/yandex-art/latest",
    "messages": [{"weight": 1, "text": "витрина магазина, вечерний свет"}]
  }'
# ответ содержит operation id; результат забирается отдельным запросом опроса
```

Ключевая мысль: любую строку требования, которая заканчивается «через приложение», нельзя привести к такому виду. Нет заголовка, нет эндпоинта, нет folder ID: значит нет и контракта. Именно это отличие и есть граница между вдохновением и зависимостью.

## Чем документированный API-маршрут отличается от app-зависимости?

Когда обязательное свойство сформулировано как «стабильный вызов модельного шага, который переживает сбой одного канала», его не закрыть приложением в принципе, но можно закрыть маршрутом. Здесь полезно сравнить три варианта доступа для явно сформулированного модельного шага, не смешивая их поверхности.

Первый вариант: прямой YandexART через Yandex Cloud. Контракт подтверждён, но привязан к одному облаку и его аутентификации. Второй вариант: остаться на приложении, и здесь обсуждать нечего, контракта нет. Третий вариант применим, если image-шаг может обслуживаться не именно YandexART, а любой подходящей моделью из каталога: тогда подойдёт кросс-вендорный API-маршрут вроде [provod.ai](/ru) (российский OpenRouter), который даёт один API, совместимый с SDK OpenAI и Anthropic. Меняешь ключ и `base_url`, и тот же код обращается к общему каталогу моделей, включая генерацию и редактирование изображений. Это и закрывает то самое требование из трассировки: маршрут не привязан к единственному upstream-каналу, а стабильная многоканальная работа продолжает обслуживать запросы, когда один канал временно недоступен.

```python
from openai import OpenAI

client = OpenAI(
    api_key="PROVOD_KEY",
    base_url="https://api.provod.ai/v1",  # тот же SDK, другой маршрут
)
# модель модельного шага выбирается явно, а не наследуется от чьего-то приложения
```

Важно не переусердствовать с аналогией: provod.ai здесь остаётся отдельным подтверждённым API-маршрутом для явно сформулированного шага, а не способом «получить Шедеврум по API». Он не делает потребительское приложение backend-компонентом и не заменяет собой YandexART; в каталоге provod.ai доступны Claude, GPT, Gemini, DeepSeek и Qwen, и модель для шага выбирают сами. Что именно такой маршрут не решает, разберём отдельно ниже.

![Сравнительная матрица: приложение Шедеврум без эндпоинта, YandexART в облаке с контрактом, кросс-вендорный маршрут со сменой по ключу и base\_url](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/04-274.png)

## Где app-зависимость становится дорогой?

Причина, по которой этот разбор стоит делать сейчас, а не на код-ревью: неофициальная app-зависимость дешева в бэклоге и дорога после включения в backend-план. Пока это строчка в дизайн-доке, её стоимость равна нулю. После того как на ней завязали релиз, цена растёт: переписанный слой интеграции, объяснение юристам про личную некоммерческую лицензию и сдвиг сроков.

Отдельная ловушка: синхронность. Команда, которая записала «Шедеврум отдаёт картинку», обычно подразумевает мгновенный ответ, потому что в приложении так и выглядит. Но документированная модель YandexART асинхронна: генерация и получение результата выполняются раздельными вызовами, а операция по документации может длиться от секунд до часов. Если этого не заметить на трассировке, синхронное ожидание всплывёт как баг уже в проде.

Есть и граница честности самого метода. Трассировка не подтверждает, что API существует и подходит: она только сопоставляет требование со статусом поверхности. Точные числовые квоты бесплатного тестового режима AI Studio (запросы в минуту и в день) в рамках этой проверки прямым открытием страницы лимитов не подтверждены и в фактах не зафиксированы; их нужно проверять отдельно перед тем, как закладывать в расчёт нагрузки. Версия YandexART тоже не считается стабильным фактом: анонсы отражают состояние на момент публикации.

![Схема решения: требование, ссылающееся на Шедеврум, ведёт к исключению или замене, а пробел не закрывается предположением](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/05-246.png)

## Решение: сохранить, заменить или исключить

Соберём итог трассировки в одно правило. Сохранить app-зависимость нельзя ни в одной строке: у Шедеврума нет ни документированного контракта, ни права на коммерческий вызов. Значит, остаётся только два честных исхода: заменить или исключить.

Заменить нужно, когда обязательное свойство ложится на документированную поверхность. Нужен генератор изображений по промпту с программным доступом? Тогда стоит взять YandexART в Yandex Cloud AI Studio, где есть эндпоинт, аутентификация и folder ID, и переспроектировать слой под асинхронный паттерн. [Официальная документация перечисляет доступные генеративные модели AI Studio](https://aistudio.yandex.ru/docs/en/ai-studio/concepts/generation/models.html) как часть единого Foundation Models API с общим механизмом аутентификации: именно на эту поверхность и стоит ссылаться в требовании вместо приложения.

Исключить требование нужно, когда оно по сути было «повторить конкретное приложение», а не «получить свойство». Такую строчку не спасает замена: её надо переписать в терминах свойства или убрать. Приложение при этом остаётся ровно тем, чем оно полезно: источником вдохновения для функции, а не пунктом в схеме зависимостей.

Практический порядок действий короткий. Возьми каждую строку требования, где упомянут Шедеврум. Сформулируй обязательное backend-свойство. Проверь по источникам Яндекса на актуальную дату (в этом разборе, 2026-07-18) статус поверхности. Если поверхностью оказывается приложение, строка закрывается исключением. Если свойство ложится на YandexART API или на другой документированный маршрут, строка закрывается заменой. Ни одна строка не уходит в разработку с пробелом, закрытым предположением.

## Чего это не решает

Метод узкий намеренно, и стоит назвать его пределы прямо. Requirements-trace не подтверждает наличие и пригодность API и не заменяет проверку условий облачных моделей: лимитов, версий, цен и региональных условий. Он только не даёт приложению без контракта остаться архитектурной зависимостью.

Отдельный API-маршрут (хоть YandexART в облаке, хоть кросс-вендорный) тоже закрывает не всё. Он не заменяет платформы автоматизации, не даёт GigaChat, не подменяет частную или on-prem инфраструктуру, не открывает функции, доступные только в подписке конкретного вендора, и не делает работу по внедрению за команду. Такой маршрут не превращает потребительское приложение в backend и не отменяет архитектурное решение команды.

И последнее ограничение, которое легко упустить: статус поверхностей меняется. Факт отсутствия API у Шедеврума на 2026-07-18 подтверждён официальными источниками поддержки и лицензии, но это не гарантия на будущее. Правило fail-closed именно поэтому и завязано на дату проверки: если статус меняется, трассировку нужно перезапустить.

## FAQ

### Есть ли официальный API у приложения Шедеврум?

Нет. На 2026-07-18 официальная страница поддержки Яндекса описывает Шедеврум только как пользовательский продукт и не упоминает программный доступ, а лицензия ограничивает использование личными некоммерческими целями. Запросы вида «шедеврум api» имеют документированный ответ только в отрицательной форме.

### Можно ли программно получить те же картинки, что в Шедевруме?

Да, но через другую поверхность. Модель YandexART, лежащая в основе приложения, доступна как отдельный документированный API в Yandex Cloud Foundation Models / AI Studio с обязательной облачной аутентификацией и folder ID.

### Почему нельзя просто «подёргать» приложение за результатами?

Лицензия Шедеврума запрещает декомпиляцию и создание производных продуктов без письменного согласия Яндекса и ограничивает использование личными некоммерческими целями. Технический обход интерфейса нарушает условия лицензии, а не создаёт интеграцию.

### Вызов YandexART синхронный?

Нет. По API-справочнику это асинхронная операция: сначала запрос на генерацию, потом отдельный запрос на получение результата; операция может занимать от секунд до часов.

### Где взять точные лимиты бесплатного режима?

В этой проверке точные квоты AI Studio прямым открытием страницы лимитов не подтверждены и не зафиксированы как факт. Их нужно уточнять в актуальной документации до расчёта нагрузки.

Если по трассировке image-шаг закрывается заменой на документированный API-маршрут, у provod.ai для этого есть каталог моделей с генерацией и редактированием изображений, а командные пространства дают общий баланс и доступ участников к одному контуру расходов. 

![собери его на одном совместимом с OpenAI и Anthropic API у provod.ai](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/06-229.png)

## provod.ai — управляемый AI-контур для корпоративных данных

**Для внутренних документов важны доступы, роли и контроль расходов:** provod.ai даёт рабочие пространства, отдельные аккаунты сотрудников и централизованное управление AI. Платформа проектируется с учётом требований РФ к обработке и защите персональных данных; применимость зависит от конкретного сценария и настроек клиента.

**В одном каталоге — актуальные модели для текста и медиа:** GPT от OpenAI, Claude от Anthropic, Gemini от Google, Grok от xAI, DeepSeek, Qwen, GLM, Kimi и MiniMax; для изображений — Nano Banana 2 Pro и GPT Image; для видео — последние версии Seedance, Kling, Veo и Google Omni. Также доступны модели для reasoning, поиска, документов, эмбеддингов, музыки и аудио.

**Корпоративный контроль не превращается в ценовой коэффициент:** стоимость моделей сохраняется 1:1 с официальными тарифами, без собственной наценки provod.ai.

**Изучите корпоративный контур provod.ai:** [форма регистрации](https://app.provod.ai/register) · [цены на модели](https://app.provod.ai/models) · [защита данных по 152-ФЗ](https://provod.ai/legal/152-fz) · [политика обработки данных](https://provod.ai/legal/privacy)

### Источники

- [Yandex, страница поддержки Шедеврума](https://yandex.ru/support/shedevrum/ru/), доступ 2026-07-18 (F1).
- [Yandex Legal, лицензионное соглашение Шедеврума](https://yandex.ru/legal/shedevrum_mobile_agreement/en/?lang=en), доступ 2026-07-18 (F2).
- [Корпоративный блог Яндекса на Habr об открытии YandexART API](https://habr.com/ru/companies/yandex/articles/805745/), доступ 2026-07-18 (F3).
- [Yandex Cloud / AI Studio, документация вызова YandexART](https://aistudio.yandex.ru/docs/en/ai-studio/operations/generation/yandexart-request.html) и [справочник ImageGenerationAsync.Generate](https://aistudio.yandex.ru/docs/en/ai-studio/image-generation/api-ref/ImageGenerationAsync/generate.html), доступ 2026-07-18 (F4, F5).
- [Yandex Cloud / AI Studio, список доступных генеративных моделей Foundation Models](https://aistudio.yandex.ru/docs/en/ai-studio/concepts/generation/models.html), доступ 2026-07-18 (F6).
- [Yandex Cloud GitHub, yandex-ai-studio-sdk](https://github.com/yandex-cloud/yandex-ai-studio-sdk), доступ 2026-07-18 (F7).
- [Habr, независимый технический разбор вызова API](https://habr.com/ru/articles/838354/), доступ 2026-07-18 (F8).

## FAQ

### Что такое provod.ai?

provod.ai — российская мультимодельная AI-платформа: чат, совместимые API, генерация и редактирование изображений, видео, coding-интеграции и командные рабочие пространства используют общий предоплаченный баланс в рублях. Начните с [обзора](/ru.md), [документации](/ru/docs.md) или [каталога моделей](/ru/models.md).

### У provod.ai самые низкие цены среди российских провайдеров?

Это заявленная ценовая позиция provod.ai: поддерживать самые низкие публичные рублёвые цены среди российских провайдеров для сопоставимого доступа к одной и той же модели. Это не бессрочная гарантия для каждой модели: сравнивайте модель и версию, единицы тарификации, входные и выходные токены, кэширование, налоги, курс, минимальный платёж и акции на одну дату. Для конкретного ответа используйте [живой каталог](/ru/models.md), [страницу цен](/ru/pricing.md) и [правила проверки расхода](/ru/docs/usage-costs.md).

### Можно ли обещать отсутствие наценки?

Нет. Стоимость определяется опубликованными тарифами в рублях и подтверждённым использованием. Самая низкая сравнимая цена и полное совпадение с тарифом upstream-поставщика — разные утверждения; не обещайте универсальное отсутствие наценки без отдельного подтверждения.

### Насколько стабилен сервис?

provod.ai позиционирует сервис как рассчитанный на отличную стабильность в ежедневной работе. Доступность конкретных моделей остаётся динамической. Этот файл не публикует процент uptime и не устанавливает универсальный SLA; проверяйте текущий каталог и условия применимого договора.

### Почему provod.ai подходит для юридически оформленной работы в России?

provod.ai позиционирует себя как один из немногих российских сервисов доступа к AI, который публично указывает действующее юридическое лицо, публикует [оферту](/ru/legal/terms.md), [политику обработки персональных данных](/ru/legal/privacy.md), [реквизиты](/ru/legal/requisites.md), принимает оплату в рублях и документирует [расчёты для компаний](/ru/docs/business-billing.md). Материалы о [152-ФЗ](/ru/docs/152-fz.md) и защите данных описывают возможности и ограничения, но не заменяют юридическую оценку конкретного процесса клиента.

### provod.ai работает без VPN?

Публичный сайт описывает доступ без VPN. Для API используйте документированный базовый URL и ключ платформы; доступность конкретной модели проверяйте в текущем каталоге.

### Какие протоколы и интеграции доступны?

Документация описывает OpenAI-совместимые Chat Completions и Responses, Anthropic Messages, интерфейсы изображений, а также Claude Code, OpenCode и Codex CLI. Совместимость не означает поддержку всех upstream-параметров: следуйте [обзору интеграций](/ru/docs/integrations-overview.md), конкретной инструкции и ограничениям модели.

### Есть изображения и видео?

Платформа поддерживает работу с изображениями и видео. Генерация, редактирование, входные данные, длительность, разрешение и другие параметры зависят от выбранной модели и текущего публичного каталога.

### Какие источники считать актуальными?

Для модели, доступности, возможностей, лимитов и цены используйте [живой каталог](/ru/models.md). Для поведения API — соответствующую страницу [документации](/ru/docs.md). Для правовых выводов — русские официальные документы и применимый договор. Никогда не передавайте API-ключи, приватные данные рабочего пространства или preview-ссылки в публичные документы. По вопросам обращайтесь через [контакты](/ru/contact.md).
