/ API
Разделы документации

Документация / Начало

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

Подключите OpenAI-совместимый клиент к AIReplica. Ниже — ключ, адрес сервиса, пример запроса и проверка ответа.

01 / Создайте ключ и пополните баланс

Зарегистрируйтесь, подтвердите почту и откройте раздел API-ключей. Скопируйте новый ключ сразу после создания. Создать аккаунт →

02 / Установите клиент и сохраните ключ

Установите пакет openai. Передайте ключ через переменную окружения AIREPLICA_API_KEY на сервере.

pip install openai # Введите свой ключ в окружении сервераexport AIREPLICA_API_KEY="YOUR_API_KEY"

03 / Отправьте запрос

from openai import OpenAI

client = OpenAI(
    api_key="sk-air-…",
    base_url="https://api.aireplica.ru/v1"
)

resp = client.chat.completions.create(
    model="openai/gpt-4o-mini",
    messages=[{"role": "user", "content": "Привет"}]
)

04 / Проверьте результат

В консоли появится ответ модели. Расход по запросу можно проверить в личном кабинете. Сначала проверьте небольшой запрос, затем подключайте рабочие данные.

Какая совместимость поддерживается

Пример использует формат OpenAI. Маршрут Anthropic /v1/messages пока не поддерживается. Допустимые параметры проверяйте для выбранной модели.

  • POST /v1/chat/completions
  • POST /v1/embeddings
  • POST /v1/rerank
  • GET /v1/models

Описание API в формате OpenAPI — api.aireplica.ru/v1/openapi.json (без ключа): только маршруты, которые сервис сейчас обслуживает.

Если запрос не выполнился

  • 401Проверьте API-ключ и заголовок авторизации.
  • 402Проверьте доступный баланс и пополните его.
  • 429Снизьте частоту запросов. Если получен Retry-After, учитывайте его перед повтором.
  • 5xxСохраните идентификатор запроса и напишите в поддержку: support@aireplica.ru. Не повторяйте платный запрос вслепую при неизвестном исходе.

Формат ошибок и поведение при сбоях — Лимиты и ошибки.