Документация

HTTP API

Отправьте запрос из своего приложения или скрипта.

1. Подготовьте ключ

Получите ключ на странице активации. Замените им YOUR_AIRAW_KEY в примере ниже.

2. Отправьте первый запрос

Сохраните код в request.py и запустите python request.py. Нужен Python 3; дополнительные пакеты не требуются.

import json
from urllib.request import Request, urlopen

request = Request(
    "https://example.invalid/v1/chat/completions",
    data=json.dumps({
        "model": "glm-5.3",
        "messages": [{"role": "user", "content": "Ответь одним словом: работает?"}],
    }).encode("utf-8"),
    headers={
        "Authorization": "Bearer YOUR_AIRAW_KEY",
        "Content-Type": "application/json",
    },
)
with urlopen(request, timeout=120) as response:
    result = json.load(response)
    print(result["choices"][0]["message"]["content"])

Ответ появится в терминале, а запрос — в кабинете. Чтобы сменить модель, скопируйте её идентификатор на главной и замените значение model.

Адреса API

Задача Метод и путь
Список доступных моделей GET /v1/models
Chat Completions POST /v1/chat/completions
Responses POST /v1/responses
Anthropic Messages POST /v1/messages

Базовый адрес: /v1. Передавайте ключ в заголовке Authorization: Bearer YOUR_AIRAW_KEY.

Пример тела для Responses

Отправьте это тело на /v1/responses с теми же заголовками, что в примере выше.

{
          "model": "glm-5.3",
          "input": "Ответь одним словом: работает?",
          "store": false
          }

Для следующего сообщения передайте историю в input. Сервер не хранит ответы для продолжения через previous_response_id.

Пример тела для Anthropic Messages

Отправьте это тело на /v1/messages. Добавьте заголовок anthropic-version: 2023-06-01.

{
          "model": "glm-5.3",
          "max_tokens": 256,
          "messages": [
          {
          "role": "user",
          "content": "Ответь одним словом: работает?"
          }
          ]
          }

Если библиотека сама добавляет /v1/messages, укажите ей базовый адрес без /v1: /.

Если запрос вернул ошибку
  • 401 — вставьте ключ целиком, без пробелов.
  • 402 — проверьте остаток токенов в кабинете.
  • 403 — проверьте, доступна ли модель вашему ключу.
  • 404 — сверьте путь и идентификатор модели.
  • 429 — повторите запрос через время из заголовка Retry-After.
  • 503 — повторите запрос позже.