Используйте API Gemini из совместимого клиента после выбора текущего идентификатора модели. Официальный каталог и документация содержат актуальные названия, конечные точки и шаблоны запросов. Храните выбранный идентификатор модели и конфигурацию клиента в одном проверенном месте. Создайте API-ключ, укажите задокументированный базовый URL и выполните небольшой запрос, который можно проверить, прежде чем добавлять этот рабочий процесс в более крупную функцию. Это сохраняет ясность конфигурации, когда позже вы будете тестировать другую модель или маршрут из списка.
Выберите актуальный идентификатор модели
Доступность моделей может меняться. Каталог — более надёжный источник, чем старое руководство.
Скопируйте идентификатор модели, которую планируете использовать.
По возможности храните идентификатор модели в конфигурации. Позже вы сможете протестировать другой Gemini вариант, не изменяя логику приложения.
Настройте совместимый клиент.
В приведённом ниже коде используется задокументированная конечная точка. Храните ключ в переменной окружения, а не добавляйте его в систему контроля версий.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ODIROUTER_API_KEY"],
base_url="https://api.odirouter.ai/v1",
)
response = client.chat.completions.create(
model="your-current-gemini-model-id",
messages=[
{
"role": "user",
"content": "Give a short summary of this test request.",
}
],
)
print(response.choices[0].message.content)Замените идентификатор модели, указанный в коде, на идентификатор из каталога. Этот пример следует шаблону chat completions из официальной документации. Если ваше приложение использует другой стиль API, начните с соответствующей документации и протестируйте этот маршрут отдельно.
Перед перенаправлением производственного трафика протестируйте интеграцию.
Начните с запроса, который легко проверить. Убедитесь, что настроенный идентификатор модели принимается, сохраните идентификатор запроса или безопасные диагностические сведения, которые ваше приложение уже регистрирует, и убедитесь, что неуспешный ответ не раскрывает учётные данные.
Затем проверьте, какие входные данные ваш продукт фактически отправляет. Небольшой текстовый запрос подтверждает подключение, но не доказывает, что другая структура запроса, вызов инструмента или ввод медиафайлов будут работать так же. Проверьте именно ту модель и конечную точку, которые необходимы вашей рабочей нагрузке.
Четко определяйте выбор модели.
OpenAI-совместимый клиент означает, что вам не придётся переписывать каждый вызов клиента при изменении конфигурации. Это не делает разные модели взаимозаменяемыми. Храните выбранный идентификатор модели, ожидаемое поведение ответа и решение по резервному варианту в одном проверенном пути конфигурации. Это упрощает последующее тестирование и делает видимыми специфичные для модели допущения.
Следующие шаги
Перед продолжением ознакомьтесь с актуальными сведениями о модели:
Здесь вы можете создать или управлять доступом: