provod.ai / docs
Помощь

Частые вопросы о 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-ФЗ. Ссылайтесь на текущие страницы вместо копирования их текста в инструкции.

На этой странице