ДОКУМЕНТАЦИЯ

Ключ API

Для использования AI Mediator через API, необходимо создать один (или несколько) ключей API в Личном Кабинете.


 


 

Вы можете создать до 6 одновременно действующих ключей. Берегите API ключи от утечек и следуйте лучшим практикам сохранности: не используйте одни и те же ключи для различных целей или в различных средах (тестирования и продуктивной), не сохраняйте ключи в GIT-репозитории, и т.п.

Созданный ключ можно проверить в “песочнице”


 

Вызов API через OpenAI-совместимое API (все модели)

Все предоставляемые нами модели (ото всех провайдеров) доступны через универсальный API-интерфейс, совместимый с OpenAI API (де-факто индустриальный стандарт).

Используйте API Base URL https://api.ai-mediator.ru/v1

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



Пример запроса с помощью curl, модель gpt-4o-mini:

curl -s https://api.ai-mediator.ru/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $API_KEY" \
    -d '{"model": "gpt-4o-mini",
        "messages":[{"role": "user", "content": "Why is the sky blue?"}]}' | jq


Пример запроса с помощью curl, получить список всех доступных моделей:

curl -s https://api.ai-mediator.ru/v1/models \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $API_KEY" \
    | jq


Пример запроса с помощью OpenAI Python SDK, модель Anthropic Claude 3.5 Haiku:

from openai import OpenAI
client = OpenAI(
                api_key=process.env('API_KEY'),
                base_url="https://api.ai-mediator.ru/v1"
               )
completion = client.chat.completions.create(
  model="claude-3-5-haiku-20241022",
  messages=[{"role": "system", "content": "You are a helpful assistant."},{"role": "user", "content": "Why is the sky blue?"}])
print(completion.choices[0].message)

Запрос остатка баланса AI Mediator

Это специальный API вызов от нашего личного кабинета.

Обратите внимание, URL начинается с https://app.ai-mediator.ru (как личный кабинет), не api. Но API-ключ тот же самый.

curl -s https://app.ai-mediator.ru/api/customer/balance \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $API_KEY" \
    | jq

Возращает текущий баланс в рублях как {"balance": 250}


Сообщить о нарушении