Быстрый старт для пользователей GLM

Установка и настройка

Для начала убедитесь, что у вас установлена официальная SDK OpenAI для вашего языка. API использует стандартную схему аутентификации на основе заголовков. Вы должны установить заголовок Authorization в значение Bearer your-api-key и настроить базовый URL на https://api.glmapi.cc/v1. Этот URL работает с любым клиентом, поддерживающим формат Chat Completions от OpenAI.

Не требуется специальной инициализации клиента, кроме стандартной конфигурации. Сервис является готовой заменой существующих интеграций OpenAI. Вы можете проверить свою настройку, обратившись к эндпоинту доступных моделей.

Первый запрос

Отправьте простой запрос на генерацию текста, чтобы проверить подключение. Используйте идентификатор модели uncensored для основной большой языковой модели. API принимает стандартные параметры, такие как max_tokens и temperature.

Этот запрос возвращает прямой текстовый ответ. Если вы получили ошибку 401, проверьте свой API-ключ. Ошибка 402 указывает на недостаточный предоплаченный баланс.

Копироватьcurl https://api.glmapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

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

Используйте официальную библиотеку Python для взаимодействия с API. Инициализируйте клиент, указав базовый URL и API-ключ. Синтаксис повторяет структуру стандартного клиента OpenAI.

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

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://api.glmapi.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

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

Для сред JavaScript используйте Node SDK. Настройте параметр baseUrl так, чтобы он указывал на наш эндпоинт API. Это гарантирует правильную маршрутизацию всех запросов на наши серверы.

SDK автоматически обрабатывает повторные попытки и разбор ответов. Вы можете передавать стандартные параметры завершения. Объект ответа содержит сгенерированный текст в ожидаемом месте.

Копироватьimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.glmapi.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Потоковая передача ответов

Включите потоковую передачу, установив параметр stream в значение true. API возвращает фрагменты данных через Server-Sent Events (SSE). Каждый фрагмент содержит частичный текст и статистику использования.

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

Копироватьstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Лимиты, ошибки и контекст

Контекстное окно поддерживает 100 000 токенов в сумме, с максимальным выводом 32 000 токенов. Запросы, превышающие лимит тела в 8 МБ, будут отклонены. Лимит составляет 300 запросов в минуту и 8 параллельных запросов на ключ.

Ошибка 401 означает недействительный ключ. Ошибка 402 указывает на отсутствие предоплаченного баланса. Ошибка 429 сигнализирует о достижении лимита запросов. Баланс не сгорает, а ошибки не расходуют токены. Приватность сохраняется; промпты не используются для обучения.