# AtlasCloud AI v1 chat completions: контрактный firewall для совместимого клиента

Source: https://provod.ai/ru/blog/api150-a134-atlascloud

Проверенный endpoint всё равно не должен получать неограниченный доступ к общему клиенту команды. Ты проверил домен, прочитал документацию, убедился, что схема совместима с OpenAI SDK, и тебе кажется логичным просто прописать base\_url и ключ. На этом шаге и открывается дыра: доверие, полученное один раз при проверке, ты по инерции превращаешь в постоянный безусловный допуск.

Дальше разбираю, как впустить AtlasCloud в общий совместимый клиент и не отдать ему больше прав, чем ты собирался. Если ты решаешь задачу оплаты и маршрутизации внешних моделей из России без танцев с картами, отдельный явно разрешённый endpoint через [provod.ai (российский аналог OpenRouter)](/ru) можно завести в той же политике, но это ход про инфраструктуру, а не подтверждение самого AtlasCloud.

Тезис, который я защищаю, простой и опровержимый: явная политика клиента уменьшает область последствий изменения контракта AtlasCloud. Если после внедрения такой политики смена пути endpoint, поля схемы или тарифа всё равно кладёт весь общий клиент, тезис ложен. Основание для него в том, что явные ограничения переживают изменение внешнего контракта, тогда как подразумеваемое доверие такого изменения не переживает.

[Подключите AI для клиентского сервиса с оплатой в рублях на provod.ai](/ru)

## Совместимость с OpenAI ещё не разрешение

AtlasCloud подаёт себя как drop-in замену. По документации (Atlas Cloud Docs, доступ 2026-07-18) базовый OpenAI-совместимый URL для SDK: `https://api.atlascloud.ai/v1`, а сам вызов chat completions идёт POST-запросом на `https://api.atlascloud.ai/api/v1/chat/completions`. Авторизация задаётся заголовком `Authorization: Bearer <token>` с ключом, который в SDK-примерах называется `ATLASCLOUD_API_KEY`, плюс обязательным `Content-Type: application/json`. Ты меняешь только строку `model`, и старый код на OpenAI SDK начинает работать с новым сервисом.

Именно эта бесшовность и создаёт проблему. Формат запроса и ответа для семейства https api atlascloud ai v1 chat completions настолько точно повторяет OpenAI SDK, что разработчик вставляет base\_url в общий клиент, которым пользуется вся команда, и проверять как будто больше нечего. Совпадение схемы он читает как гарантию поведения.

Но схема и поведение не одно и то же. Совместимый формат описывает, как выглядит запрос и ответ сейчас, и ничего не говорит о том, останется ли путь `/api/v1/chat/completions` прежним, не переедут ли поля ответа, не сменится ли тариф. Документация AtlasCloud представляет собой живой версионируемый веб-продукт, а не закреплённую спецификацию: пути, поля запроса и ответа, политика лимитов могут измениться без видимой записи в changelog. Это не предсказание о будущем поведении сервиса, а свойство поверхности, с которой ты интегрируешься.

## Что AtlasCloud гарантирует, а что нет

Разберём контракт по тому, что реально написано в документах AtlasCloud, а не по маркетинговому ощущению. Схема запроса принимает `model`, `messages`, `max_tokens`, `temperature`, `top_p`, `top_k`, `repetition_penalty`, `stream`, `systemPrompt` и необязательный объект `thinking`. Ответ возвращает `id`, `object: "chat.completion"`, `created`, `model`, `choices` с `finish_reason` и блок `usage` со счётчиком токенов. Это и есть точная форма контракта, против которой имеет смысл валидировать ответ на стороне клиента.

По ошибкам документированы `401 (Unauthorized)` и `422 (Unprocessable Entity)`. А вот фиксированной числовой таблицы лимитов нет: FAQ AtlasCloud (доступ 2026-07-18) прямо говорит, что лимиты «варьируются по тарифу аккаунта и типу модели» и «щедрые для большинства продакшн-нагрузок», а `429` предлагается разруливать клиентским backoff или заявкой в поддержку на повышение. Перевести это на язык интеграции можно однозначно: предсказуемая пропускная способность тебе не обещана.

Отдельно стоит зафиксировать то, чего в контракте нет вообще. По документации ключей AtlasCloud (доступ 2026-07-18) ключи дают одинаковый доступ без разграничения прав, без политики истечения и, что особенно важно, без встроенного лимита расхода на ключ. Оплата идёт pay-as-you-go, расход по всем типам моделей складывается в единый баланс аккаунта, а не режется по интеграциям. За endpoint стоит 400+ моделей (LLM, изображения, видео, аудио), выбираемых просто сменой строки `model`; серверного allowlist, ограничивающего, какие ID моделей может звать конкретный ключ, тоже нет.

Сложи это вместе, и портрет получается такой: знакомая схема, честная почасовая тарификация, но ни фиксированного лимита, ни бюджетного потолка на ключ, ни серверного ограничения на модели и endpoint. Всё это придётся собрать самому.

![Сравнение того, что AtlasCloud гарантирует в контракте и что оставляет на клиента](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/02-280.png)

## Из чего собрать контрактный firewall

Firewall здесь понимается не как сетевой барьер, а как контрактный: набор явных ограничений в самом клиенте, через которые проходит любой запрос к внешнему endpoint. Пять полей закрывают ровно те дыры, которые AtlasCloud оставляет на тебя. Формулу удобно держать в голове как единый ярлык: «домен-модель-лимит-таймаут-блокировка».

Разрешённый домен. Клиент принимает base\_url только из allowlist. Проверенный сегодня `api.atlascloud.ai` попадает в список осознанно, а не потому что кто-то вставил строку в конфиг. Домен вне allowlist служит причиной отклонить конфигурацию, а не поводом разбираться в нём потом.

Whitelist заголовков и allowlist моделей. Поскольку серверного ограничения на модели нет, его держит клиент: список ID, которые этому ключу дозволено звать. Заодно фиксируется набор заголовков, чтобы совместимая форма запроса не расползалась.

Таймаут. Внешний сервис без гарантированной пропускной способности обязан иметь верхнюю границу ожидания на стороне клиента: иначе один медленный ответ держит весь поток. Отсутствие таймаута тоже становится причиной отклонить endpoint.

Потолок расхода и триггер блокировки. Это самое важное, потому что здесь у AtlasCloud документированная пустота: бюджетного лимита на ключ нет, а видимость расхода доступна только постфактум в консоли. Значит, счётчик и порог живут в клиенте. Как только порог превышен, клиент блокирует дальнейшие вызовы этого endpoint, а не ждёт, пока единый баланс аккаунта покажет перерасход задним числом.

![Диагностический маршрут: пять проверок клиентской политики перед отправкой запроса](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/03-280.png)

## Как это выглядит в конфиге

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

```python
# policy.py - контрактный firewall общего клиента
ENDPOINT_POLICY = {
    "atlascloud": {
        "base_url": "https://api.atlascloud.ai/v1",   # только из allowlist
        "allowed_headers": {"Authorization", "Content-Type"},
        "allowed_models": {"<model-id-1>", "<model-id-2>"},  # свой список
        "timeout_seconds": 30,
        "spend_ceiling_units": 100000,   # счётчик и порог живут здесь
        "on_exceed": "block",
    },
}

def check(request, policy):
    p = policy[request.endpoint]
    assert request.base_url == p["base_url"], "домен вне allowlist"
    assert request.model in p["allowed_models"], "модель не разрешена"
    assert request.timeout <= p["timeout_seconds"], "нет/великоват таймаут"
    assert usage_counter(request.endpoint) < p["spend_ceiling_units"], "бюджет"
    return request
```

Валидировать ответ стоит против той самой формы, что задокументирована: наличие `object: "chat.completion"`, разбираемый `choices[].finish_reason`, присутствие `usage`. Если поле переехало, клиент отклонит ответ на границе и не даст битой структуре пройти в бизнес-логику. Это дешёвая страховка ровно от того сценария, ради которого firewall и строится.

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

## Где здесь место для российской инфраструктуры

Сравним по одной оси: предсказуемости оплаты и доступа из России. AtlasCloud тарифицируется pay-as-you-go в единый баланс, без потолка на ключ; для оплаты и легального доступа из РФ ты решаешь вопросы карт и каналов отдельно. Если задача состоит именно в том, чтобы свести внешние модели к рублёвому счёту и стабильному каналу, в ту же политику клиента заводится второй, явно разрешённый endpoint: [provod.ai](/ru). Он держит один API, совместимый с OpenAI и Anthropic SDK: меняешь ключ и base\_url, а весь каталог моделей (Claude, GPT, Gemini, DeepSeek, Qwen) доступен из того же клиента. Оплата идёт с одного рублёвого баланса российской картой, через СБП или по счёту, без VPN и зарубежных карт, а цены на модели даются без наценки самого сервиса.

Ещё две вещи ложатся прямо на тему статьи. Стабильная мультиканальная маршрутизация продолжает работу, когда один вышестоящий канал временно недоступен: это тот же принцип ограничения последствий, только на уровне провайдера, а не клиента. А защищённый российский контур маскирует прямые персональные идентификаторы до отправки запроса во внешнюю модель и поддерживает процессы по 152-ФЗ. Оговорюсь честно: это решение по оплате и маршрутизации, а не подтверждение качества или надёжности самого AtlasCloud, и не замена твоей проверке его контракта.

![Расход интеграций стекается в единый баланс аккаунта при отсутствии лимита на ключ](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/04-278.png)

## Решающая таблица: пускать или нет

Сведу критерии допуска в одну таблицу. Она читается как контракт допуска endpoint: пока хотя бы одна строка красная, endpoint в общий клиент не попадает.

| Условие | Источник контроля | Если не выполнено |
| --- | --- | --- |
| Домен в allowlist | Политика клиента | Отклонить конфиг |
| Разрешённые заголовки | Whitelist клиента | Отклонить запрос |
| Модель в allowlist | Клиент (серверного нет, F9) | Блок вызова |
| Таймаут задан | Политика клиента | Отклонить endpoint |
| Потолок расхода | Клиент (лимита на ключ нет, F6) | Блок при превышении |
| Схема ответа совпадает | Валидатор против F3 | Отклонить ответ |

Логика решения такая: нет проверенного домена, значит не подключаем вообще; нет лимита расхода в клиенте, значит тоже не подключаем, потому что провайдер его не даст; схема несовместима, значит опять не подключаем. Всё остальное сводится к вариантам одного и того же выбора: прямой endpoint без ограничений мы отвергаем как раз по этим критериям, а отдельный явно разрешённый endpoint с политикой принимаем, оплачивая это конфигурационным слоем.

![Таблица допуска endpoint: шесть условий и реакция клиента на невыполнение](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/05-250.png)

## Чего эта политика не решает

Она не подтверждает AtlasCloud. Свойства сервиса до проверки остаются для меня неизвестными; я не гонял по нему ни одного собственного теста, лога или бенчмарка, и любой конкретный сценарий отказа здесь служит иллюстрацией, а не зафиксированным инцидентом. То, что endpoint прошёл проверку контракта, представляет собой установленный шаг доверия. То, что контракт может измениться после допуска, остаётся гипотезой о будущем поведении, и firewall лишь ограничивает её последствия, не отменяя саму возможность.

Она не даёт SLA. Отдельной страницы статуса или uptime у AtlasCloud я не нашёл, а часто цитируемое «99.99%» живёт в маркетинге, не в договорном документе, и опираться на него как на гарантию нельзя. Числовые значения лимитов и поштучные цены зависят от тарифа и модели, поэтому единственного «того самого» числа тут нет: сверяйся с живой консолью и карточкой модели на момент интеграции.

И она не заменяет то, чем не является по определению: платформы автоматизации, GigaChat, приватную или on-prem инфраструктуру, функции, доступные только по подписке у вендора, и работу по внедрению. Firewall ограничивает область последствий, а не снимает с тебя ответственность за архитектуру.

## FAQ

### Разве OpenAI-совместимость не значит, что можно просто подключиться?

Совместимость описывает форму запроса и ответа сегодня. Она не гарантирует ни стабильность пути endpoint, ни лимит, ни бюджет. Совместимость не отменяет контроль: она лишь снижает стоимость интеграции.

### Почему потолок расхода должен быть в клиенте, а не у провайдера?

Потому что у AtlasCloud задокументировано отсутствие лимита расхода на ключ (F6), а видимость трат доступна только постфактум в консоли. Это не гипотеза, а зафиксированный пробел, который закрывается только на твоей стороне.

### Если endpoint уже проверен, зачем ограничивать модели?

Серверного allowlist моделей нет (F9): любой валидный ключ может звать любую из 400+ моделей сменой строки `model`. Список дозволенных ID держит клиент.

### Почему в статье встречаются два разных пути к chat completions?

Прямой REST-вызов идёт на `https://api.atlascloud.ai/api/v1/chat/completions`. Если использовать OpenAI SDK с base\_url `https://api.atlascloud.ai/v1`, SDK сам добавляет `/chat/completions` при вызове запроса. Это два способа обратиться к одному контракту, а не два разных сервиса, но в политику firewall нужно внести именно тот путь, который реально отправляет твой клиент.

![provod.ai как разрешённый endpoint: один рублёвый баланс, совместимый API и стабильная маршрутизация](https://storage.yandexcloud.net/provod-yc-production-cms-media/blog/06-233.png)

## provod.ai — единая точка доступа к развивающемуся AI-рынку

**Новые востребованные модели добавляются максимально быстро:** при появлении нового поставщика команде не нужно заново строить интеграцию — API, баланс и привычные инструменты сохраняются. Доступность конкретной модели проверяется в живом каталоге.

**В одном каталоге — актуальные модели для текста и медиа:** 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, поиска, документов, эмбеддингов, музыки и аудио.

**Новая модель появляется без дополнительного «налога за новизну» со стороны provod.ai:** цена соответствует официальному тарифу провайдера 1:1.

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

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

- Atlas Cloud Docs, createChatCompletion, доступ 2026-07-18: endpoint, авторизация, схема, ошибки 401/422, каталог моделей.
- Atlas Cloud, developer, доступ 2026-07-18: base\_url, язык FAQ о вариативности лимитов и `429`.
- Atlas Cloud, pricing/models, доступ 2026-07-18: pay-as-you-go, единый баланс.
- Atlas Cloud Docs, account overview, доступ 2026-07-18: разделение Billing и API Keys.
- Atlas Cloud Docs, api-keys, доступ 2026-07-18: отсутствие лимита расхода на ключ и разграничения прав.
- Проверенные продуктовые факты provod.ai, 2026-07-15.

## 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).
