Ошибка 403: что делать, если gemini-3-flash-preview не отвечает

Код 403 означает, что вы аутентифицированы, но доступ запрещён: ключ действителен, однако вызывать эту модель или эту группу им нельзя.

403 Forbidden означает, что личность распознана, но доступа нет. Разница с 401: 401 — это «кто ты», 403 — «у тебя нет прав». Обычно нужно добавить модель в список разрешённых или в группу, привязанную к ключу.

gemini-3-flash-preview предоставляется компанией Google. Всё на этой странице — причины, решения и измеренные данные — собрано по реальной работе этой модели на уровне шлюза.

В этом шлюзе самая частая причина — Ключ не авторизован для этой модели. Рекомендуемое первое действие: Добавьте модель в список разрешённых для ключа на странице «Токены».

Возможные причины

  • Ключ не авторизован для этой модели
  • Модель не входит в группу, к которой привязан ключ
  • У ключа задан список разрешённых IP, и ваш IP в него не входит
  • Модель снята с поддержки или требует более высоких прав

Как исправить

  • Добавьте модель в список разрешённых для ключа на странице «Токены»
  • Убедитесь, что группа ключа включает эту модель
  • Проверьте настройки списка разрешённых IP
  • Переключитесь на модель, к которой есть доступ

Повтор с экспоненциальной задержкой

Ниже — пример повтора, когда gemini-3-flash-preview возвращает 403: до 5 попыток, ожидание растёт и добавляется случайный джиттер, чтобы параллельные запросы не повторялись одновременно. Base URL и API key читаются из переменных окружения — не хардкодьте их.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gemini-3-flash-preview'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Ключевые данные этой модели

API-эндпоинтhttps://api.airai.cc/v1
Совместимо с OpenAIOpenAI-compatible
ПроизводительGoogle
Контекст1M
ВозможностиReasoning, Tools, Files, Vision, Audio
Форматы APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Формула биллингаp * 0.5 + cr * 0.05 + ai * 1 + c * 3

Частые вопросы

Экспоненциальный backoff или фиксированный интервал?

Обычно не нужно менять код, достаточно скорректировать темп вызовов. Повтор — самый эффективный первый шаг. При тарифе p * 0.5 + cr * 0.05 + ai * 1 + c * 3 неудачные запросы не идут в использование. Для повторяемых ошибок используйте экспоненциальную задержку, для остальных возвращайте ошибку сразу.

Будет ли списание, если gemini-3-flash-preview вернул 403?

Оплачивается только уже сгенерированный вывод, неудачная часть — нет. При тарифе p * 0.5 + cr * 0.05 + ai * 1 + c * 3 неудачные запросы не идут в использование. Сначала проверьте баланс и лимиты скорости в консоли, потом ищите в коде. Оценивая стоимость по p * 0.5 + cr * 0.05 + ai * 1 + c * 3, учитывайте и бюджет на повторы.

Длинный контекст повышает вероятность 403?

Нужно менять параметры запроса, один повтор не поможет. Это проблема конфигурации клиента, на сервере менять ничего не нужно. Окно контекста 1M задаёт максимальный ввод за запрос; всё, что больше, отклоняется сразу. Для ошибок параметров сразу возвращайте ошибку, не тратя повторы.

Связана ли 403 с возможностями самой модели?

Эта ошибка не связана с возможностями модели, это уровень шлюза. Как правило это кратковременный сбой, который проходит сам. Теги возможностей модели: Reasoning, Tools, Files, Vision, Audio. Если ошибка длится несколько минут, обратитесь в поддержку платформы и уточните статус upstream.

Другие ошибки этой модели

Другие модели с той же ошибкой

Вернуться к странице модели

Данные обновлены: 2026-10-10 08:15

Техническая поддержкаОнлайн-поддержка
Наверх