Вопросы и ответы

Как выбрать модель?

Откройте библиотеку, выберите тип и найдите модель по имени. Передавайте точный ID. В карточке видны протоколы, контекст, инструменты, поддержку изображений, effort и значения по умолчанию. Публичный ID сохраняется при смене подходящего внутреннего маршрута.

Почему резерва больше, чем окончательного расхода?

До обращения к модели сервер защищает ваш баланс: резервирует консервативный вход и максимально разрешённый выход. После получения usage резерв освобождается и списывается фактический расход по сохранённому тарифу. Уменьшите max_tokens, если нужен короткий ответ. Instructions и схемы инструментов тоже входят во входные токены.

Как узнать цену заранее?

В карточке LLM показаны серверные ставки и бесплатный калькулятор по числу токенов. Для медиа используйте расчёт по настройкам. Когда цена зависит от входного файла, загрузите свой файл и вызовите POST /v1/generations/quote. Расчёт не запускает генерацию.

Что делать при потере ответа?

Не создавайте новую платную задачу с новым ключом повтора. Сохраните X-Request-ID, прочитайте GET /v1/requests/{id} и повторите исходный запрос с прежними Idempotency-Key и телом. Изменение тела под тем же ключом возвращает 409.

Почему картинка не принимается?

Проверьте vision для выбранного протокола, формат, размеры и число изображений. Для LLM разрешены data URL и собственные file IDs. Приватные IP и внешние URL не загружаются. Изменение расширения файла не меняет его фактический MIME.

Кто исполняет tool calls?

Ваше приложение или CLI. RenderFox передаёт структуру вызова и принимает результат с тем же call ID. Ограничьте разрешённые функции, файлы и команды на стороне приложения. Аргументы из частичного SSE нужно сначала собрать и проверить.

Как долго доступна история Responses?

store=true сохраняет содержимое Responses на 24 часа для продолжения диалога вашим аккаунтом. DELETE удаляет сохранённое содержимое; сведения об оплате сохраняются. Временные загрузки имеют expires_at и защищаются от удаления во время использования. Срок хранения бухгалтерских записей не равен сроку временных медиа или текста.

Что делать, если ключ раскрыт?

Удалите ключ в кабинете или замените его новым, обновите ENV приложения и проверьте использование. Отозванный ключ перестаёт авторизовать новые запросы. Уже принятая платная задача сохраняет собственное финансовое состояние и не исчезает из истории.

Как передать ошибку поддержке?

Передайте request ID, UTC-время, HTTP code и model ID. Не отправляйте полный API ключ, секреты поставщиков, пользовательские тексты и медиа в публичные логи. Для 429 учитывайте Retry-After, для 402 проверьте баланс и ограничения ключа.