Qwen Руководство по API

Редакция OdiRouter

Чтобы добавить вызов API Qwen, сначала выберите нужную модель и эндпоинт, который будет использовать ваше приложение. В каталоге представлены актуальные варианты, а в документации указан совместимый базовый URL. Используйте идентификатор модели, доступный вашей учётной записи.

Что необходимо перед отправкой запроса

Создайте или используйте ключ API OdiRouter, затем найдите идентификатор модели Qwen в актуальном OdiRouter model catalog. Доступность, параметры и цены могут меняться. Проверяйте каталог и документацию по модели, а не полагайтесь на старый пример.

Для вызовов языковых моделей OdiRouter документирует https://api.odirouter.ai/v1 как совместимый с OpenAI базовый URL. Передавайте ключ API в заголовке запроса. Храните токен в секретном хранилище или переменной окружения, никогда не в клиентском коде или репозитории.

Выберите идентификатор модели в актуальном каталоге

Откройте model catalog, выберите модель Qwen, соответствующую рабочей нагрузке, и скопируйте указанный там идентификатор. В каталоге можно проверить поддерживаемые эндпоинты, типы входных и выходных данных, параметры и актуальные цены.

При разработке интеграции используйте заполнитель:

YOUR_QWEN_MODEL_ID

Замените его только после подтверждения идентификатора модели в каталоге для ключа API и эндпоинта, которые вы будете использовать.

Отправьте минимальный запрос

В этом запросе используется описанный в документации путь завершения чата. Идентификатор модели и токен являются заполнителями.

curl --location 'https://api.odirouter.ai/v1/chat/completions' \
  --header 'Authorization: Bearer $ODIROUTER_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "YOUR_QWEN_MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Write a short release-note summary for a developer audience."
      }
    ]
  }'

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

Используйте клиент, совместимый с OpenAI

Если приложение уже использует клиент, совместимый с OpenAI, укажите в качестве его базового URL OdiRouter и загрузите ключ API через обычный для приложения механизм управления секретами.

from openai import OpenAI

client = OpenAI(
    base_url="https://api.odirouter.ai/v1",
    api_key="YOUR_ODIROUTER_API_KEY",
)

response = client.chat.completions.create(
    model="YOUR_QWEN_MODEL_ID",
    messages=[
        {
            "role": "user",
            "content": "Give this support reply a clear, friendly tone.",
        }
    ],
)

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

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

Проверьте интеграцию перед запуском в продакшене

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

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

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

Выберите актуальную модель Qwen в OdiRouter model catalog. Затем используйте документированный эндпоинт и актуальные параметры модели, чтобы выполнить первый вызов API Qwen.

Источники

#Qwen API