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

Использование API

OpenAI-совместимый API: base_url, первый запрос и адреса эндпоинтов.

Совместимость с OpenAI

Шлюз принимает запросы в форматах OpenAI Chat Completions и Responses, а также Anthropic Messages. Стандартные SDK и клиенты работают без доработок: укажите базовый адрес и передавайте ключ в заголовке Authorization: Bearer YOUR_AIRAW_KEY.

Базовый адрес

Базовый адрес API — /v1 (в продакшене: https://api.airaw.eu.cc/v1). Ключ берите на странице активации и заменяйте им YOUR_AIRAW_KEY в примерах.

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

curl /v1/chat/completions \
  -H "Authorization: Bearer YOUR_AIRAW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.3",
    "messages": [{"role": "user", "content": "Ответь одним словом: работает?"}]
  }'

Ответ содержит поле choices[0].message.content. Запрос сразу виден в кабинете.

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

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

import json
from urllib.request import Request, urlopen

request = Request(
    "/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"])

Адреса эндпоинтов

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

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

Если запрос вернул ошибку

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