Entwickler-API

Nutzungsbedingungen der API

1. KI-API: nur rechtmäßige Inhalte, keine Spam-/Massen-Erzeugung, keine Ausgabe als Äußerung echter Personen; Anfragen gehen an den eingestellten KI-Anbieter. Downloader-API: Nur legale Nutzung: Lade ausschließlich eigene Inhalte oder Inhalte, für die du die nötigen Rechte hast (z. B. Creative Commons, ausdrückliche Erlaubnis). Keine Umgehung von Kopierschutz (DRM), kein Weiterverkauf, kein öffentliches Wiederveröffentlichen fremder Werke.
2. Die Nutzungsbedingungen von YouTube, Spotify und TikTok bleiben unberührt; die Verantwortung für die Nutzung liegt bei dir.
3. Schlüssel sind persönlich und geheim: nicht weitergeben, nicht in öffentlichen Code/Apps einbauen. Bei Missbrauch oder Verdacht werden Schlüssel ohne Vorwarnung gesperrt.
4. Es gibt Limits je Schlüssel (Anfragen pro Stunde/Tag). Keine Garantie auf Verfügbarkeit; die API kann jederzeit geändert oder abgeschaltet werden.
5. Gespeichert werden: Antrag (Projekt, Begründung, Kontakt), ein Hash des Schlüssels (nie der Klartext), Zeitpunkt der letzten Nutzung und Anzahl der Aufrufe. Geladene Dateien liegen höchstens 1 Stunde bereit.

Authentifizierung

Header Authorization: Bearer jv_… (oder X-API-Key). Den Schlüssel siehst du nur einmal beim Erstellen.

curl -H "Authorization: Bearer $JV_KEY" https://HOST/api/v1/status

Endpunkte

POST /api/v1/youtube – {"url":"https://youtu.be/…","format":"mp4|mp3","legal":true}

POST /api/v1/spotify – {"query":"Titel Künstler oder Spotify-Link","legal":true} (MP3)

POST /api/v1/tiktok – {"url":"https://www.tiktok.com/@…/video/…","legal":true} (MP4)

Antwort: {"ok":true,"title":…,"file":"/api/v1/file/<token>","fileUrl":…,"expiresAt":…,"limits":{…}} – Datei per GET laden (1 h gültig, kein Schlüssel nötig).

curl -X POST -H "Authorization: Bearer $JV_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://youtu.be/aqz-KE-bpKQ","format":"mp3","legal":true}' https://HOST/api/v1/youtube

Fehler: {"ok":false,"error":"rate_limit|unauthorized|scope|invalid_url|…","message":…}, bei 429 mit Retry-After.

🤖 KI-API (eigener Antrag)

POST /api/v1/ai/chat – {"messages":[{"role":"user","content":"Hallo"}],"botName":"MeinBot"} (oder {"prompt":"…"}) → {"ok":true,"botName":…,"reply":…,"limits":{…}}

Chat über die eingestellte KI des Bots, max. 20 Nachrichten à 4000 Zeichen. Einziger Eingriff: botName (wie sich die KI nennt). Kein Zugriff auf Gedächtnis, Befehle/Werkzeuge, Nutzerdaten, Systemprompt oder Einstellungen des Bots. Eigene Limits je Schlüssel. Beantragen im Portal unter „🔑 Entwickler-API“ → API „🤖 KI-API“.

curl -X POST -H "Authorization: Bearer $JV_KEY" -H "Content-Type: application/json" \
  -d '{"prompt":"Erklär mir JSON in einem Satz","botName":"Nova"}' https://HOST/api/v1/ai/chat