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

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

Предварительные требования

Аккаунт Glacier AI. При регистрации может потребоваться подтвердить адрес электронной почты.
Доступная квота на аккаунте. Если у нового аккаунта нулевой баланс, сначала пополните счёт или активируйте код в Кошельке.

В примерах на этой странице адрес сайта записан как https://api.example.com — замените его на тот, которым вы пользуетесь.

Шаг 1. Зарегистрироваться и войти

Откройте главную страницу сайта и нажмите «Вход» справа вверху или перейдите сразу на /sign-in.
Если аккаунта нет, нажмите «Регистрация» или перейдите на /sign-up, укажите имя пользователя и пароль, при необходимости подтвердите почту и пройдите проверку на робота.
После входа вы попадёте в консоль. В левой навигации отображаются модули, доступные вашему аккаунту.

Подробности — в разделе Регистрация и вход.

Шаг 2. Создать API-ключ

Нажмите «API-ключи» в левой навигации или перейдите на /keys.
Нажмите «Создать API-ключ» и укажите имя (лучше по назначению, например «Продакшн» или «Тесты»).
При необходимости задайте квоту, срок действия, ограничения по моделям, группу и список разрешённых IP. Если не уверены, оставьте поля пустыми — это означает отсутствие ограничений.
После сохранения откройте список, чтобы посмотреть и скопировать полный ключ вида sk-xxxxxxxx.

Подробности — в разделе API-ключи.

Шаг 3. Отправить первый запрос

Платформа предоставляет API, совместимый с OpenAI. Достаточно заменить базовый URL официального SDK на адрес вашего сайта с суффиксом /v1.

curl https://api.example.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет"}]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxxx",
    base_url="https://api.example.com/v1",
)

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет"}],
)
print(response.choices[0].message.content)

Если писать код не хочется, нажмите «Playground» в левой навигации (/playground) — там можно выбрать модель и начать диалог прямо в браузере.

Шаг 4. Проверить расход и тарификацию

Нажмите «Журналы использования» в левой навигации или перейдите на /usage-logs/common.
Найдите только что отправленный запрос и проверьте модель, число токенов, длительность и списанную квоту.
Нажмите на запись, чтобы раскрыть подробности: идентификатор запроса, сопоставление моделей, детали тарификации и прочее.

Подробности — в разделе Журналы и асинхронные задачи.

Типичные проблемы

Симптом	Что проверить
Ответ 401 Unauthorized	Формат `Authorization: Bearer <ключ>`, включён ли ключ и не истёк ли его срок.
Ответ 403 Forbidden	Ограничения по моделям, права группы и список разрешённых IP для ключа.
Недостаточно квоты	Баланс или квоту подписки в разделе Кошелёк, а также лимит квоты самого ключа.
Модель не найдена	В Каталоге моделей — включена ли модель и доступна ли она текущей группе.
Записи нет в журналах	Журналы пишутся с задержкой в несколько секунд — подождите и обновите страницу. Не каждый неуспешный ответ создаёт запись об ошибке.

Что дальше

Обзор руководства: указатель всех возможностей и рекомендуемый порядок чтения.
Использование API и Playground: все поддерживаемые конечные точки и вызовы в нативных форматах.
Интеграция чат-приложений: перенос настроек в популярные ИИ-клиенты в один клик.