Zum Hauptinhalt springen
Avala bietet offizielle SDKs und Client-Bibliotheken, um Ihnen die Integration mit der Plattform in Ihrer bevorzugten Sprache oder Ihrem bevorzugten Framework zu erleichtern. Jedes SDK umhüllt die Avala REST API mit idiomatischen Methoden, integrierter Authentifizierung, automatischen Wiederholungsversuchen und vollständiger Typsicherheit.

Client-Bibliotheken

Python

Synchrone und asynchrone Unterstützung. Vollständige Type Hints. Python 3.9+.

TypeScript

Vollständig typisiert. Keine Abhängigkeiten. Funktioniert in Node.js, Deno und Bun.

CLI

Datensätze, Exporte und Speicher von Ihrem Terminal aus verwalten. curl -fsSL https://avala.ai/install.sh | bash.

REST API

Die API direkt aus jeder Sprache mit HTTP-Anfragen nutzen.

OpenAPI

Generieren Sie Ihren eigenen Client aus der OpenAPI-Spezifikation.

Schnellvergleich

FunktionPythonTypeScriptCLIREST API
Installationpip install avalanpm install @avala-ai/sdkcurl -fsSL https://avala.ai/install.sh | bashDirektes HTTP
AsyncSync + AsyncAsyncN/ABeliebig
TypsicherheitVollständige Type HintsVollständige TypeScript-TypenN/AN/A
Automatische WiederholungJaJaÜber SDKManuell
PaginierungIntegrierte IteratorenIntegrierte Iteratoren--limit-FlagManuell
Abhängigkeitenhttpx, pydanticKeine (nativer Fetch)click, richN/A

Umgebungsvariablen

Alle SDKs respektieren die folgenden Umgebungsvariablen, sodass Sie sie einmal konfigurieren und über Ihren gesamten Stack hinweg nutzen können.
VariableBeschreibungStandard
AVALA_API_KEYIhr Avala API Key zur Authentifizierung. Wird automatisch verwendet, wenn kein Key an den Client-Konstruktor übergeben wird.Keiner (erforderlich)
AVALA_BASE_URLÜberschreibt die Standard-API-Basis-URL. Nützlich für Self-Hosted-Deployments oder Entwicklungsumgebungen.https://api.avala.ai/api/v1

Authentifizierung

Alle Anfragen an die Avala API müssen Ihren API Key im X-Avala-Api-Key Header enthalten. Sie finden Ihren API Key im Avala Dashboard unter Einstellungen > Sicherheit.
export AVALA_API_KEY="your-api-key"
Sobald die Umgebungsvariable gesetzt ist, verwenden alle SDKs sie automatisch ohne zusätzliche Konfiguration.

MCP-Integration

Nutzen Sie Avala mit KI-Assistenten wie Claude, Cursor und VS Code über das Model Context Protocol. Das Paket @avala-ai/mcp-server stellt Ihre Datensätze, Projekte und Exporte als Werkzeuge bereit, die KI-Assistenten direkt aufrufen können.