Интеграция OpenAI SDK с OdiRouter

Интеграция с OpenAI SDK позволяет приложению сохранять привычный интерфейс SDK, отправляя запросы в OdiRouter. Создайте API-ключ OdiRouter, укажите для клиента https://api.odirouter.ai/v1 и используйте актуальный идентификатор модели OdiRouter. Это руководство охватывает официальные способы настройки для Python и Node.js, а также проверки, позволяющие выявить распространённые ошибки конфигурации.

Перед настройкой клиента

Вам нужны учётная запись и API-ключ OdiRouter. В OdiRouter introduction описаны настройка учётной записи и первый запрос. Установите OpenAI SDK для вашей среды выполнения, затем сохраните ключ в серверной переменной окружения. Не помещайте API-ключ в браузерную сборку или публичный репозиторий.

В примерах не указана конкретная модель, поскольку ее доступность может меняться. Прежде чем выбрать модель, проверьте OdiRouter models page или вызовите GET https://api.odirouter.ai/v1/models.

Настройка OpenAI SDK для Python

Установите пакет:

pip install openai

Создайте клиент, используя ваш ключ OdiRouter и базовый URL-адрес API OdiRouter:

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_MODEL_ID",
    messages=[
        {"role": "user", "content": "Reply with a short integration test."}
    ],
)

print(response.choices[0].message.content)

Сначала проверьте base_url, если SDK по-прежнему отправляет запросы в другой сервис. Чтобы интеграция работала, он должен указывать на OdiRouter.

Настройка OpenAI SDK для Node.js

Установите пакет:

npm install openai

Настройте клиент в серверном коде Node.js:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.ODIROUTER_API_KEY,
  baseURL: "https://api.odirouter.ai/v1",
});

Отправьте запрос после выбора актуального идентификатора модели:

const response = await client.chat.completions.create({
  model: "YOUR_MODEL_ID",
  messages: [
    { role: "user", content: "Reply with a short integration test." },
  ],
});

console.log(response.choices[0].message.content);

Запускайте этот код в серверном маршруте, бэкенд-процессе или другой среде, где ODIROUTER_API_KEY остаётся конфиденциальным. Клиентская сборка может раскрыть ключ посетителям.

Выбирайте идентификатор модели осознанно

SDK отправляет поле model в точности в указанном виде. Причиной неудачного запроса может быть выбор модели, а не SDK. Перед развертыванием получите список доступных моделей из каталога OdiRouter и скопируйте точный идентификатор в конфигурацию. official OpenAI SDK setup guide — это текущий эталонный URL-адрес и примеры интеграции.

Для приложений, выполняющих несколько задач, храните выбор модели в конфигурации. Это делает изменения модели заметными и позволяет коду приложения сосредоточиться на запросах и ответах.

Устранение неполадок с первым запросом

Если кажется, что SDK вызывает другой сервис, проверьте base_url в Python или baseURL в Node.js. Ответ 401 или ответ о недействительном ключе означает, что приложению нужен API-ключ OdiRouter. Ответ о том, что модель не найдена, означает, что следует сверить идентификатор модели с GET https://api.odirouter.ai/v1/models.

Начните с однострочного запроса и записывайте в журнал только сведения об ответе, безопасные для вашей среды. Не регистрируйте ключ API. После успешного выполнения этого запроса добавьте сообщения приложения, потоковую обработку и обработку ошибок вокруг того же настроенного клиента.

Следующий шаг

Создайте учётную запись на OdiRouter, создайте API-ключ и используйте OpenAI SDK documentation в качестве актуального справочника по настройке.