Scotty.AI
Zur Startseite REST API

API-Dokumentation

Scotty AI als programmatischer Endpoint — für eigene Bots, Widgets oder Hausautomatisierung.

Beta · API-Keys auf AnfragePublic-Endpoint geplant Q3 2026 · Self-hosting bereits möglich

Base URL

https://scotty-ai.project-zora.space/api/v1

Authentifizierung

Header: Authorization: Bearer YOUR_API_KEY — Keys gibt's via Telegram-DM auf Anfrage. Anonyme Nutzung mit Rate-Limit (10 req/Tag/IP) ohne Header möglich.

Endpoints

POST /chat

Schickt eine Frage an Scotty, gibt Antworttext + ggf. Tool-Calls zurück. Body: { "message": "...", "session_id": "..." }

GET /quota

Liefert aktuelles Rate-Limit für die aufrufende Identität.

GET /tools

Listet alle 12 verfügbaren HAFAS-MCP-Tools mit Schema.

POST /voice

Multipart-Upload eines Audio-Files (ogg/wav/mp3) → Transkription via Whisper.

GET /health

Status-Check. Gibt 200 OK wenn HAFAS, Claude und MCP erreichbar sind.

SDKs

Noch keine offiziellen SDKs — Beispiele in Python, TypeScript und Bash gibt's im GitHub Repo unter /examples.

Rate Limits

  • Anonym: 10 req / Tag / IP
  • Mit API-Key: 1000 req / Tag (Standard) — höhere Limits auf Anfrage
  • Voice-Endpoint: 50 req / Tag aufgrund Server-Last