Zum Hauptinhalt springen

VIDEO KOMMT BALD

Erste Schritte mit Avala

5-6 Min. • API-Key-Einrichtung, SDK-Installation, erster API-Aufruf

Voraussetzungen: Sie benötigen ein Avala-Konto. Registrieren Sie sich auf avala.ai oder erstellen Sie eines programmatisch mit dem SDK (siehe unten), dann erstellen Sie einen API Key unter Einstellungen > Sicherheit.
pip install avala

from avala import Client

client = Client(api_key="avk_your_api_key")

for dataset in client.datasets.list():
    print(dataset.name, dataset.item_count)
Das war’s. Im Folgenden finden Sie eine Schritt-für-Schritt-Anleitung, was passiert und was Sie als Nächstes tun können.

​
Konto erstellen

Sie können sich auf avala.ai registrieren oder ein Konto programmatisch erstellen. Die SDK-Funktion signup erfordert keinen API Key — sie gibt bei Erfolg einen zurück. 
from avala import signup

result = signup(email="dev@acme.com", password="SecurePass123!")
print(f"API Key: {result.api_key}")

​
API Key erhalten

  1. Melden Sie sich bei Mission Control an.
  2. Gehen Sie zu Einstellungen > Sicherheit.
  3. Klicken Sie auf API Key erstellen, geben Sie einen Namen ein, wählen Sie Berechtigungen und kopieren Sie den Key.
API Keys werden nur einmal bei der Erstellung angezeigt. Speichern Sie den Key an einem sicheren Ort, bevor Sie den Dialog schließen.
Setzen Sie ihn als Umgebungsvariable, damit alle SDKs und das CLI ihn automatisch verwenden: 
export AVALA_API_KEY="avk_your_api_key"

​
Datensätze auflisten

from avala import Client

client = Client()  # liest AVALA_API_KEY aus der Umgebung

for dataset in client.datasets.list():
    print(f"{dataset.name} — {dataset.item_count} Elemente")

​
Projekte auflisten

for project in client.projects.list():
    print(f"{project.name} ({project.status})")

​
Export erstellen

export = client.exports.create(project="proj_uid_here")
print(f"Export {export.uid}: {export.status}")
Exporte laufen asynchron. Fragen Sie den Status mit client.exports.get(uid) ab oder prüfen Sie avala exports get <uid>, bis der Vorgang abgeschlossen ist.

​
Rate-Limit-Nutzung prüfen

Die SDKs stellen Rate-Limit-Header aus jeder Antwort bereit: 
info = client.rate_limit_info
print(f"{info['remaining']}/{info['limit']} Anfragen verbleibend")
print(f"Zurückgesetzt um: {info['reset']}")

​
Nächste Schritte

Python SDK

Async-Unterstützung, Paginierung, Fehlerbehandlung und vollständige Type Hints.

TypeScript SDK

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

CLI-Referenz

Verwalten Sie Datensätze, Projekte, Exporte und Speicher von Ihrem Terminal aus.

Webhooks

Erhalten Sie Echtzeitbenachrichtigungen für Datensatz-, Export- und Aufgabenereignisse.

MCP Server

Nutzen Sie Avala mit Claude, Cursor und VS Code über KI-Assistenten.

API-Referenz

Vollständige Endpoint-Referenz mit Request- und Response-Schemas.