Быстрый старт

Чтобы отправить первый запрос к API, зарегистрируйтесь, пополните баланс организации, создайте API-ключ и выберите точный идентификатор модели. После этого можно обратиться к базовому адресу https://route.smartaipack.ru/v1 напрямую по HTTP или через уже используемый в проекте пакет openai.

Ниже разберём три способа подключения: прямой запрос, пакет openai и стороннюю библиотеку с поддержкой OpenAI-совместимого адреса. Во всех примерах ключ хранится в переменной окружения AI_GATEWAY_API_KEY и не записывается в исходный код.

Что понадобится

1. Зарегистрируйтесь или войдите в AI Gateway.
2. Откройте личный кабинет и убедитесь, что баланс организации положительный. Без средств на балансе запросы по ключу приостанавливаются. Условия тарификации опубликованы на странице цен.
3. В разделе API-ключи нажмите Создать ключ, укажите понятное название и сразу сохраните выданное значение. Полный ключ показывается только один раз.
4. Откройте раздел Модели. Скопируйте точный model ID модели, доступной для /v1/chat/completions. В примерах используется gpt-5.5; если в вашем каталоге указан другой ID, замените значение без сокращений и переименований.
5. Используйте базовый URL https://route.smartaipack.ru/v1. Путь /chat/completions добавляется к нему только при прямом HTTP-запросе; клиентская библиотека добавит путь сама.

Перед запуском примеров задайте ключ в текущей сессии терминала:

export AI_GATEWAY_API_KEY="<ВАШ_API-КЛЮЧ>"

Не добавляйте настоящий ключ в Git, журналы приложения, скриншоты или сообщения поддержки. Для сервера храните его в принятом в вашем проекте хранилище секретов.

1. Использование API напрямую

Прямой запрос подходит для быстрой проверки, скрипта без клиентской библиотеки или интеграции на любом языке с HTTP-клиентом.

curl https://route.smartaipack.ru/v1/chat/completions \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Объясни в двух предложениях, что такое API."
      }
    ]
  }'

В успешном ответе текст модели находится в choices[0].message.content. Если шлюз сообщает, что модель не найдена или недоступна на этом пути, снова скопируйте точный ID из раздела Модели и проверьте, что для неё указан /v1/chat/completions.

2. Использование OpenAI SDK

AI Gateway поддерживает OpenAI-совместимый формат запросов. Если в проекте уже используется пакет openai, для подключения достаточно передать адрес AI Gateway, ключ и точный ID модели. Если пакета в проекте нет, установите его обычным для проекта способом и зафиксируйте версию в файле зависимостей.

Python

import os

from openai import OpenAI

client = OpenAI(
    base_url="https://route.smartaipack.ru/v1",
    api_key=os.environ["AI_GATEWAY_API_KEY"],
)

completion = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {
            "role": "user",
            "content": "Объясни в двух предложениях, что такое API.",
        }
    ],
)

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

JavaScript и TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://route.smartaipack.ru/v1",
  apiKey: process.env.AI_GATEWAY_API_KEY
});

const completion = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [
    {
      role: "user",
      content: "Объясни в двух предложениях, что такое API."
    }
  ]
});

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

Этот пример рассчитан на серверную среду Node.js. Не передавайте секретный API-ключ в браузерный JavaScript: пользователь сможет увидеть его в коде страницы или сетевых запросах.

3. Использование сторонних библиотек

Отдельный SDK AI Gateway не нужен. Стороннюю библиотеку можно подключить, если она позволяет вручную задать все три параметра:

Названия настроек зависят от библиотеки: адрес может называться base_url, baseURL, endpoint или API base. Перед подключением проверьте в документации самой библиотеки, что она поддерживает пользовательский OpenAI-совместимый адрес и не добавляет к нему лишний /v1.

Не включайте дополнительные возможности модели только по названию библиотеки. Сначала проверьте в каталоге AI Gateway, какие пути и возможности указаны у выбранной модели. Для первого теста используйте обычный запрос к /v1/chat/completions из примеров выше.

Как проверить результат и расход

После успешного ответа откройте Использование: там находится журнал отдельных запросов. Сводные графики и разбивка по моделям и ключам доступны в разделе Аналитика.

Если запрос не проходит, проверьте по порядку:

• переменная AI_GATEWAY_API_KEY задана в том же окружении, где запускается код;
• в заголовок передаётся Bearer и сам ключ без лишних пробелов;
• базовый адрес равен https://route.smartaipack.ru/v1 и не содержит повторного /v1;
• model точно совпадает с ID в каталоге моделей;
• ключ активен, а баланс организации положительный.

Если эти проверки не помогли, обратитесь в поддержку AI Gateway. Не отправляйте полный API-ключ: достаточно описать время запроса, путь, ID модели и полученный код ошибки.