Клиентские библиотеки
Python
Синхронная и асинхронная поддержка. Полные аннотации типов. Python 3.9+.
TypeScript
Полная типизация. Ноль зависимостей. Работает в Node.js, Deno и Bun.
CLI
Управление наборами данных, экспортами и хранилищем из терминала.
curl -fsSL https://avala.ai/install.sh | bash.REST API
Используйте API напрямую из любого языка через HTTP-запросы.
OpenAPI
Сгенерируйте собственный клиент из спецификации OpenAPI.
Быстрое сравнение
| Функция | Python | TypeScript | CLI | REST API |
|---|---|---|---|---|
| Установка | pip install avala | npm install @avala-ai/sdk | curl -fsSL https://avala.ai/install.sh | bash | Прямой HTTP |
| Async | Sync + Async | Async | Н/Д | Любой |
| Типобезопасность | Полные аннотации типов | Полные типы TypeScript | Н/Д | Н/Д |
| Автоматические повторы | Да | Да | Через SDK | Вручную |
| Пагинация | Встроенные итераторы | Встроенные итераторы | Флаг --limit | Вручную |
| Зависимости | httpx, pydantic | Нет (нативный fetch) | click, rich | Н/Д |
Переменные окружения
Все SDK учитывают следующие переменные окружения, поэтому вы можете настроить их один раз и использовать во всём стеке.| Переменная | Описание | По умолчанию |
|---|---|---|
AVALA_API_KEY | Ваш API-ключ Avala для аутентификации. Используется автоматически, если ключ не передан в конструктор клиента. | Нет (обязательно) |
AVALA_BASE_URL | Переопределение базового URL API. Полезно для self-hosted развёртываний или сред разработки. | https://api.avala.ai/api/v1 |
Аутентификация
Все запросы к Avala API должны включать ваш API-ключ в заголовкеX-Avala-Api-Key. Вы можете найти API-ключ в панели управления Avala в разделе Настройки > Безопасность.
Интеграция MCP
Используйте Avala с AI-ассистентами, такими как Claude, Cursor и VS Code, через Model Context Protocol. Пакет@avala-ai/mcp-server предоставляет ваши наборы данных, проекты и экспорты как инструменты, которые AI-ассистенты могут вызывать напрямую.