FAQ

Общее

Что такое Atlas Cloud?

Atlas Cloud — это платформа-агрегатор AI API. Один API-ключ и один баланс дают доступ к более чем 400 моделям — языковым, для изображений, видео, аудио и 3D — от множества провайдеров, без отдельной регистрации у каждого из них.

С чего начать?

1. Создайте аккаунт
2. Создайте API-ключ
3. Выполните первый запрос по инструкции Быстрый старт

Какие модели доступны?

Смотрите Библиотеку моделей. Каталог часто меняется, поэтому именно он является авторитетным источником — документация намеренно не фиксирует названия моделей, которые быстро устаревают.

Совместим ли API с OpenAI?

Да, и не только с ним. Atlas Cloud принимает шесть форматов запросов: OpenAI Chat Completions, Completions, Responses и Images, а также Anthropic Messages и Google Gemini. См. Протоколы LLM API.

API и технические вопросы

Я вызываю модель и получаю 400. Почему?

Самая частая причина — выбран неподходящий для этой модели протокол. Не каждая модель принимает каждый формат:

• Модели семейства Anthropic ожидают POST /v1/messages, а не /v1/chat/completions
• Некоторые модели OpenAI для рассуждений и семейства codex ожидают POST /v1/responses, а не /v1/chat/completions

Каждая модель публикует список поддерживаемых протоколов. Загляните в справочник API модели, прежде чем менять формат, и посмотрите Протоколы LLM API, чтобы понять различия между ними.

Какие есть эндпоинты API?

Базовый URL: https://api.atlascloud.ai

Моя задача долго находится в статусе processing. Можно ли её отменить?

Генерация изображений, видео, аудио и 3D — асинхронная. Отправьте задачу, а затем опрашивайте GET /api/v1/model/prediction/{id}, пока она не перейдёт в терминальное состояние. Видеозадачи, в частности, могут занимать минуты.

Эндпоинта отмены не существует. Задачи, превысившие таймаут платформы, завершаются принудительно, а средства возвращаются автоматически.

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

Поддерживаются ли вебхуки?

Да, для задач генерации изображений, видео и аудио. Формат полезной нагрузки и проверку подписи см. в разделе Вебхуки.

Как загружать файлы?

Используйте POST /api/v1/model/uploadMedia и передайте полученный URL в запрос генерации. Также можно указать публичный URL напрямую или встроенный Base64 для большинства полей изображений и аудио. См. Загрузка файлов.

Есть ли лимиты запросов?

Да, они применяются к аккаунту и к каждой модели. При превышении возвращается 429.

Учтите, что эндпоинты LLM и медиа не возвращают заголовки лимитов, поэтому прочитать остаток квоты из ответа невозможно — реализуйте экспоненциальное отступление. См. Ошибки и лимиты запросов.

Нужны более высокие лимиты? Свяжитесь с нами и укажите ожидаемый объём.

Я получаю ошибки 401. Как это отладить?

Проверьте в таком порядке:

1. Ключ верный и всё ещё активен? Проверьте в разделе API-ключи
2. У ключа правильная область действия? Ключ Coding Plan не может вызывать модели, которые его не принимают
3. Если вы работаете в команде — используется ли ключ, созданный в нужном аккаунте?
4. Правильный ли путь URL? Шлюз выполняет аутентификацию до маршрутизации, поэтому опечатка в пути тоже даёт 401, а не 404

Что такое MCP-сервер?

Официальный MCP-сервер, который предоставляет Atlas Cloud в виде инструментов внутри IDE с поддержкой ИИ — генерируйте медиа, общайтесь с моделями и проверяйте баланс, не покидая редактор.

Цены и оплата

Цена на карточке модели — это итоговая стоимость?

Нет — для моделей изображений и видео это цена за единицу. Итоговая стоимость зависит от параметров: длительности, разрешения и количества результатов. Видеомодель с ценой за секунду обойдётся в эту ставку, умноженную на длину клипа.

Чтобы узнать точную сумму до того, как тратить средства, воспользуйтесь оценкой стоимости перед отправкой. Разобранные примеры см. в разделе Как тарифицируются модели.

Почему цена, которую я видел, не совпала со счётом?

Различаться могут три вещи:

• На карточке модели показана прейскурантная цена за единицу
• Playground пересчитывает стоимость по мере изменения параметров
• В вашем счёте дополнительно учитываются скидки и акции по аккаунту

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

Тарифицируются ли неудачные запросы?

Нет. Задачи, которые завершились ошибкой, вышли по таймауту или были отклонены модерацией контента, не тарифицируются. Если вы видите списание, которое не можете объяснить, обратитесь в поддержку и укажите ID предсказания.

Может ли баланс уйти в минус?

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

Можно ли тратить кредиты Coding Plan на изображения или видео?

Нет. Coding Plan — это отдельный подписочный лимит для работы с языковыми моделями, и его нельзя потратить на генерацию изображений, видео или аудио. Они списываются с обычного баланса. Кредиты Coding Plan также нельзя конвертировать в баланс аккаунта.

Как получить счёт-фактуру?

Запросите его или выпустите повторно из истории платежей в панели управления. Ссылки на скачивание действуют ограниченное время, поэтому сохраняйте PDF сразу после формирования.

Какие способы оплаты принимаются?

Кредитные и дебетовые карты (через Stripe), WeChat Pay, Alipay и криптовалюта. Платежи обрабатываются в долларах США.

Есть ли бонусы за регистрацию или реферальная программа?

Atlas Cloud время от времени проводит акции на пополнение — смотрите на странице оплаты, что действует сейчас. Есть и реферальная программа: поделитесь своей ссылкой и получайте кредиты, когда приглашённый вами пользователь совершит первое пополнение. См. Баланс и кредиты.

Истекает ли срок действия кредитов?

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

Контент и модерация

Генерация видео завершилась ошибкой об авторских правах или чувствительном аудио. Что делать?

Обычно причина в звуковой дорожке, а не в видео. Варианты:

• Отключите генерацию звука, если он вам не нужен — многие видеомодели принимают флаг вида generate_audio: false
• Подставьте собственное аудио без роялти в качестве саундтрека
• Переформулируйте промпт так, чтобы просить оригинальную музыку, а не называть существующий трек или исполнителя

Запросы, заблокированные модерацией, не тарифицируются.

Моя генерация была заблокирована модерацией контента. Почему?

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

Модель, которой я пользовался, исчезла. Что произошло?

Модели иногда выводятся из эксплуатации, когда провайдер прекращает их поддержку или падает их надёжность. Библиотека моделей всегда отражает то, что доступно прямо сейчас. Если исчезла модель, от которой вы зависите, обратитесь в поддержку — мы подскажем замену.

Аккаунты и команды

Я вошёл через GitHub, но не могу пополнить баланс.

GitHub не всегда возвращает адрес электронной почты, а для оплаты он обязателен. Добавьте email в настройках аккаунта, затем пополняйте баланс как обычно.

Я вошёл в систему, а баланс пропал.

Возможно, вы создали второй аккаунт. Вход через Google, GitHub и по email создаёт отдельные аккаунты даже с одинаковым адресом, если они не были связаны. Входите тем же способом, которым регистрировались изначально. Если дубликаты уже созданы, обратитесь в поддержку.

Что умеют командные аккаунты?

Командные аккаунты имеют общий баланс, поддерживают нескольких участников с ролями и позволяют создавать API-ключи в области команды. Расходы можно разложить по ключам и по участникам, а баланс — переводить между личным аккаунтом и командой. См. Командный аккаунт и Управление доступом на основе ролей.

Как удалить аккаунт?

Напишите в поддержку с зарегистрированного адреса электронной почты и укажите UUID аккаунта. Учтите, что:

• Остаток баланса не возвращается — сначала израсходуйте его
• Есть период отмены, в течение которого запрос можно отозвать
• После закрытия тот же email нельзя будет использовать для повторной регистрации

Если вы хотите лишь удалить сгенерированный контент, а не закрывать аккаунт, можно удалить записи истории напрямую. См. Политику удаления данных.

Данные и безопасность

Как обрабатываются мои данные?

Запросы передаются по TLS. Atlas Cloud хранит содержимое запросов лишь непродолжительное время — для оказания услуги и тарификации, а у каждого вышестоящего провайдера действует своя политика хранения. См. Хранение данных и Политику конфиденциальности.

Используется ли мой контент для обучения моделей?

Нет. Atlas Cloud не использует контент, отправленный через платформу, для обучения, дообучения, оценки или бенчмаркинга размещённых моделей, если вы не разрешили это письменно.

Могу ли я управлять сроком хранения своих данных?

Да. Запросы на генерацию медиа принимают заголовки хранения на уровне запроса, которые сокращают срок хранения сгенерированных файлов и записей о запросах. См. Хранение данных.

Как обстоят дела с правами на защиту данных?

Вы в любой момент можете запросить доступ к своим персональным данным, их удаление или экспорт. Пишите на [email protected]. В разделе Политика удаления данных описано, что удаляется, а что должно быть сохранено по юридическим и бухгалтерским причинам.

Как получить помощь

• Документация — просмотрите боковое меню или начните с Быстрого старта
• Поддержка по email — [email protected]
• Сообщество — Discord
• Продажи и цены на большие объёмы — [email protected]
• Запросы о конфиденциальности — [email protected]

Сообщая о проблеме с API, приложите заголовок X-Request-ID из неудачного ответа или ID предсказания для задачи генерации. См. Ошибки и лимиты запросов.