Частые вопросы о provod.ai
Короткие ответы о старте, оплате, API, моделях, командах и обращении в поддержку.
Обновлено
Здесь собраны короткие ответы и ссылки на подробные инструкции. Текущие модели, цены, способы оплаты и состояния операций проверяйте в кабинете, а не по старым числовым примерам.
Начало работы и аккаунт
С чего начать работу с provod.ai?
Создайте аккаунт, выберите задачу и, если нужен API, отправьте один короткий запрос без потоковой передачи. Пошаговый путь и рабочий пример находятся в разделе Начало работы.
Как зарегистрироваться или войти?
При регистрации используйте телефон или Яндекс ID, если эта кнопка показана; при повторном входе выбирайте способ, уже связанный с аккаунтом. Все варианты и восстановление доступа описаны в статье Аккаунт и доступ.
Что делать, если не пришёл код из SMS?
Проверьте номер и запросите новый код, когда кнопка станет доступна; вводите только последнее сообщение. Если проблема остаётся, передайте поддержке номер в скрытом виде, время и текст ошибки по инструкции Аккаунт и доступ.
Что произошло с аккаунтом Promptra?
Promptra — прежнее название сервиса, а старые ссылки на сайт и кабинет перенаправляются на provod.ai. Войдите прежним способом и проверьте рабочее пространство, баланс и маскированные префиксы ключей по инструкции проверки.
Оплата, баланс, резервы и использование
Это подписка или оплата по использованию?
provod.ai использует предоплатную модель: подтверждённое использование списывается из общего рублёвого баланса. Категории токенов и проверка итоговой суммы разобраны в статье Использование и стоимость.
Как пополнить баланс и какая минимальная сумма?
Откройте баланс активного пространства и используйте способ оплаты и минимум, которые показывает текущая форма. Для физлица доступны показанные картой и СБП варианты, а для профиля ООО или ИП создаётся счёт; подробности есть в статье Баланс и пополнение.
Почему часть баланса зарезервирована?
Перед запросом сервис временно удерживает оценку его стоимости, поэтому доступная сумма может быть меньше общей, особенно при параллельной работе. После завершения подтверждённый расход списывается, а неиспользованная часть освобождается по правилам из статьи Баланс и пополнение.
Почему агент потратил больше, чем видно в последнем сообщении?
Агент может выполнить много отдельных запросов и в каждом повторно передать историю и результаты инструментов. Сравнивайте весь журнал запросов в разделе использования по статье Использование и стоимость.
Оплачивается ли прерванный запрос?
Сбой до подтверждённого ответа или данных об использовании не создаёт плату за использование, но уже доставленная часть потока или подтверждённое использование могут быть оплачены. Граница списания и безопасные действия описаны в статьях Использование и стоимость и Лимиты и повторы.
API-ключи и подключение
Как создать и сохранить API-ключ?
Создайте ключ в активном рабочем пространстве и сразу сохраните полное значение: повторно оно не показывается. Потерянный или раскрытый ключ отзовите и замените по статье Авторизация API.
Какой базовый URL использовать?
Для совместимых с OpenAI клиентов используйте https://api.provod.ai/v1; Claude Code получает https://api.provod.ai без /v1, потому что сам добавляет путь Messages. Выберите точную схему в обзоре интеграций.
Можно ли вызывать API прямо из браузера?
Не помещайте платформенный ключ в код или публичную сборку браузера, где его сможет получить другой человек. Вызывайте provod.ai с доверенного сервера, как описано в статье Авторизация API.
Поддерживается ли Responses API?
Да. POST /v1/responses поддерживает переносимый сценарий Responses: поток, function tools, previous_response_id и Conversations. Hosted-инструменты, включая Responses web_search и file_search, не поддерживаются; подробности есть в статье Responses и Conversations.
Ошибки и долгие запросы
Что означает ошибка API?
Сначала прочитайте HTTP-статус и публичный error.code или верхнеуровневый code, затем выберите действие по таблице. Формы ошибок и безопасный список данных для диагностики находятся в статье Ошибки API.
Нужно ли повторять запрос после 429 или 5xx?
API_KEY_SPEND_LIMIT_EXCEEDED требует дождаться resetAt или изменить бюджет, а временный сбой можно ограниченно повторить только до начала результата. Используйте Retry-After, если он есть, и правила из статьи Лимиты и повторы.
Что делать с долгим или прерванным потоком?
Поток помогает получать длинный ответ частями, но не отменяет все тайм-ауты; закрытие до завершающего события означает неполный результат. После первой части сохраните её и не повторяйте запрос автоматически, следуя статье Лимиты и повторы.
Модели и возможности
Где посмотреть актуальные модели, цены и лимиты?
Используйте каталог моделей или GET /v1/models, потому что состав и доступность меняются. Копируйте точный идентификатор и проверяйте возможности по статье Выбор модели.
Почему модель отмечена замком?
В личном пространстве FIRST_TOP_UP_REQUIRED означает, что для модели нужно первое реальное пополнение; у организаций правила могут отличаться. Проверьте причину в текущем каталоге и активное пространство по статье Выбор модели.
Доступны ли генерация и редактирование изображений?
Да, кабинет и опубликованные адреса изображений поддерживают генерацию, а редактирование доступно моделям с соответствующей возможностью. Выбирайте модель и опции из текущего каталога по статье Images API.
Доступна ли генерация видео?
Да, видео создаётся в кабинете и через асинхронный POST /v1/videos; текущие модели возвращает GET /v1/videos/models. Выберите модель в публичном каталоге, создайте задачу один раз, проверяйте её состояние и загружайте готовый результат по документации видео в кабинете.
Есть ли публичные методы для векторных представлений, аудио и веб-поиска?
В публичном /v1 сейчас нет методов для векторных представлений, расшифровки или перевода аудио и Responses web_search. Веб-поиск доступен как возможность чата в кабинете, а внешние агенты могут использовать собственные инструменты; границы перечислены в обзоре интеграций.
Команды и оплата для бизнеса
Как создать организацию и пригласить коллег?
Создайте организацию в настройках, выберите роль и отправьте приглашение по email или одноразовой ссылке. Переключение рабочих пространств и роли описаны в статье Команды и организации.
Могут ли участники видеть чаты друг друга?
Чаты принадлежат организации, и участники с доступом на чтение видят её диалоги; роль «Биллинг» такого доступа не получает. Для изолированной работы используйте личное пространство или отдельную организацию по статье Команды и организации.
Общие ли баланс, ключи и использование в организации?
Они относятся к активной организации: её ключи расходуют её баланс, а запросы отображаются в её разделе использования. Создавайте отдельные ключи для проектов, но не считайте их способом скрыть чаты внутри той же организации; подробности есть в статье Команды и организации.
Как ООО или ИП получить счёт?
Сохраните платёжный профиль ООО или ИП в активной организации, затем создайте и скачайте счёт на странице баланса. Статусы, правовые ссылки и канал для вопросов о документах находятся в статье Оплата для бизнеса.
Поддержка, аккаунт и запросы о данных
Куда обращаться за технической поддержкой?
Для входа, подключения и технической ошибки используйте Telegram @provodai. Передайте публичный код, модель, время, клиент и маскированный префикс ключа по списку из статьи Ошибки API, но не полный ключ.
Куда писать по счетам и документам компании?
Для компаний, счетов и закрывающих документов используйте info@provod.ai и укажите организацию и номер счёта. Каналы связи также перечислены на странице Контакты без обещания срока ответа.
Что делать, если не получается войти?
Попробуйте способ, уже связанный с аккаунтом, и восстановление пароля только для настроенного входа по почте. Если это не помогает, передайте поддержке телефон или почту в скрытом виде, способ входа, время и снимок ошибки по статье Аккаунт и доступ.
Как отправить запрос об аккаунте или персональных данных?
Напишите на info@provod.ai и сверяйтесь с действующей политикой обработки данных. Эта документация не обещает способ проверки личности, объём удаления или срок выполнения запроса.
Где находятся правовые документы и информация о 152-ФЗ?
Действующие страницы включают оферту, политику обработки данных, реквизиты и отдельную информацию о 152-ФЗ. Ссылайтесь на текущие страницы вместо копирования их текста в инструкции.