AI Aggregator - Маркетплейс алгоритмов ИИ

Ai-Aggregator

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

Быстрый старт

Добро пожаловать в документацию AIAG API! Этот раздел поможет вам быстро начать работу с нашим API для взаимодействия с современными языковыми моделями.

Установка

Для начала работы вам потребуется API ключ. Получите его в личном кабинете после регистрации.

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

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

curl https://api.aiag.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4",
    "messages": [
      {
        "role": "user",
        "content": "Привет! Как дела?"
      }
    ]
  }'

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

import requests

url = "https://api.aiag.ru/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "model": "gpt-4",
    "messages": [
        {
            "role": "user",
            "content": "Привет! Как дела?"
        }
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

API Reference

AIAG API предоставляет REST API для взаимодействия с языковыми моделями. Базовый URL: https://api.aiag.ru/v1

POST /chat/completions

Создает ответ на основе переданных сообщений.

Параметры:

model (string, обязательно): ID модели для использования
messages (array, обязательно): Массив сообщений диалога
temperature (number, опционально): Значение от 0 до 2, по умолчанию 1
max_tokens (number, опционально): Максимальное количество токенов в ответе
stream (boolean, опционально): Потоковая передача ответа

Аутентификация

AIAG API использует API ключи для аутентификации. Включите ваш API ключ в заголовок Authorization всех запросов:

Authorization: Bearer YOUR_API_KEY

Ваш API ключ можно найти в личном кабинете в разделе "API ключи". Храните ключ в безопасности и не передавайте его третьим лицам.

Важно: Все API запросы должны выполняться через HTTPS. Запросы через HTTP будут отклонены.

Модели

AIAG предоставляет доступ к различным языковым моделям. Каждая модель оптимизирована для определенных задач.

GPT-4

Самая мощная модель для сложных задач, требующих глубокого понимания контекста.

ID модели: gpt-4

GPT-3.5 Turbo

Быстрая и эффективная модель для большинства повседневных задач.

ID модели: gpt-3.5-turbo

Claude 3

Передовая модель от Anthropic с фокусом на безопасность и точность.

ID модели: claude-3-opus

Примеры

Потоковая передача

Пример использования потоковой передачи ответа:

import requests

url = "https://api.aiag.ru/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}
data = {
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Расскажи историю"}],
    "stream": True
}

response = requests.post(url, json=data, headers=headers, stream=True)
for line in response.iter_lines():
    if line:
        print(line.decode('utf-8'))

Настройка температуры

Управление креативностью ответов через параметр temperature:

data = {
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Напиши стихотворение"}],
    "temperature": 0.8,  # Более креативные ответы
    "max_tokens": 500
}

response = requests.post(url, json=data, headers=headers)
print(response.json()['choices'][0]['message']['content'])

SDK

Мы предоставляем официальные SDK для популярных языков программирования, чтобы упростить интеграцию.

Python SDK

Установка:

pip install aiag

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

from aiag import AIAG

client = AIAG(api_key="YOUR_API_KEY")

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

print(response.choices[0].message.content)

JavaScript/TypeScript SDK

Установка:

npm install @aiag/sdk

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

import { AIAG } from '@aiag/sdk';

const client = new AIAG({
  apiKey: 'YOUR_API_KEY'
});

const response = await client.chat.completions.create({
  model: 'gpt-4',
  messages: [
    { role: 'user', content: 'Привет!' }
  ]
});

console.log(response.choices[0].message.content);