Документация API - AI MEDIATOR | Руководство по интеграции с OpenAI, Claude, Gemini

Ключ 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 $AI_MEDIATOR_API_KEY" \
    -d '{"model": "gpt-4o-mini",
        "messages":[{"role": "user", "content": "Why is the sky blue?"}]}' | jq

Получить список всех доступных моделей

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

Пример с OpenAI Python SDK, модель Claude 3.5 Haiku

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get('AI_MEDIATOR_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)

Пример с OpenAI JavaScript SDK

import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: process.env.AI_MEDIATOR_API_KEY,
    baseURL: "https://api.ai-mediator.ru/v1"
});

const completion = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [
        { role: "system", content: "You are a helpful assistant." },
        { role: "user", content: "Why is the sky blue?" }
    ]
});

console.log(completion.choices[0].message);

Подключение Claude Code

Для использования AI Mediator с Claude Code необходимо установить две переменные окружения:

export ANTHROPIC_AUTH_TOKEN=$AI_MEDIATOR_API_KEY
export ANTHROPIC_BASE_URL=https://api.ai-mediator.ru/v1
claude

После установки переменных окружения запустите Claude Code командой claude

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

Это специальный API вызов для запроса текущего баланса. Обратите внимание, URL начинается с "app" как у личного кабинета, а не с "api".

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

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