Методы AITUNNEL

Узнайте о специальных методах API AITUNNEL для получения статистики и управления балансом. Полное руководство по использованию дополнительных эндпоинтов.

AITUNNEL предоставляет дополнительные методы API для получения статистики использования и управления балансом. Эти методы доступны только через API AITUNNEL и не являются частью стандартного API OpenAI.

Получение баланса

Эндпоинт /v1/aitunnel/balance позволяет получить информацию о текущем балансе вашего аккаунта.

Запрос

type BalanceRequest = {
  // Пустой объект, так как все необходимые данные передаются через заголовок Authorization
};

Ответ

type BalanceResponse = {
  balance: number; // Текущий баланс в рублях
};

Пример использования

TypeScript

// Использование fetch
const response = await fetch("https://api.aitunnel.ru/v1/aitunnel/balance", {
  method: "GET",
  headers: {
    Authorization: "Bearer <AITUNNEL_API_KEY>",
    "Content-Type": "application/json",
  },
});

const data = await response.json();
console.log(`Текущий баланс: ${data.balance} RUB`);

// Использование OpenAI SDK
const OpenAI = require("openai");

const client = new OpenAI({
  apiKey: "<AITUNNEL_API_KEY>",
  baseURL: "https://api.aitunnel.ru/v1/",
});

const res = await client.get("/aitunnel/balance");
console.log(res);

Python

import requests

api_key = "<AITUNNEL_API_KEY>"
headers = {
  "Authorization": f"Bearer {api_key}"
}

response = requests.get(
  'https://api.aitunnel.ru/v1/aitunnel/balance',
  headers=headers
)

data = response.json()
print(f"Текущий баланс: {data['balance']} RUB")

Shell

curl https://api.aitunnel.ru/v1/aitunnel/balance \
  -H "Authorization: Bearer <AITUNNEL_API_KEY>" \
  -H "Content-Type: application/json"

Получение статистики

Эндпоинт /v1/aitunnel/stats позволяет получить статистику использования API за день и за последние 31 день.

Запрос

type StatsRequest = {
  // Пустой объект, так как все необходимые данные передаются через заголовок Authorization
};

Ответ

type StatsResponse = {
  daily_usage: number; // Расходы за текущий день в рублях
  monthly_usage: number; // Расходы за последние 31 день в рублях
};

Пример использования

TypeScript

// Использование fetch
const response = await fetch("https://api.aitunnel.ru/v1/aitunnel/stats", {
  method: "GET",
  headers: {
    Authorization: "Bearer <AITUNNEL_API_KEY>",
    "Content-Type": "application/json",
  },
});

const data = await response.json();
console.log(`Расходы за день: ${data.daily_usage} RUB`);
console.log(`Расходы за месяц: ${data.monthly_usage} RUB`);

// Использование OpenAI SDK
const OpenAI = require("openai");

const client = new OpenAI({
  apiKey: "<AITUNNEL_API_KEY>",
  baseURL: "https://api.aitunnel.ru/v1/",
});

const res = await client.get("/aitunnel/stats");
console.log(res);

Python

import requests

api_key = "<AITUNNEL_API_KEY>"
headers = {
  "Authorization": f"Bearer {api_key}"
}

response = requests.get(
  'https://api.aitunnel.ru/v1/aitunnel/stats',
  headers=headers
)

data = response.json()
print(f"Расходы за день: {data['daily_usage']} RUB")
print(f"Расходы за месяц: {data['monthly_usage']} RUB")

Shell

curl https://api.aitunnel.ru/v1/aitunnel/stats \
  -H "Authorization: Bearer <AITUNNEL_API_KEY>" \
  -H "Content-Type: application/json"

Информация об использовании в ответах

В ответах на запросы к моделям добавляется поле usage с информацией о:

• Количестве использованных токенов
• Стоимости запроса в рублях
• Текущем балансе

Это позволяет отслеживать расходы непосредственно в ответах API.

Обработка ошибок

При возникновении ошибок эти методы возвращают стандартный формат ошибок AITUNNEL. Наиболее распространенные коды ошибок:

• 401: Недействительный API ключ
• 429: Превышен лимит запросов к API статистики

Подробнее об обработке ошибок читайте в разделе Обработка ошибок.