Fehlercodes - Runbase Docs

Bekannte API-Fehler geben einen JSON-Body mit dieser Struktur zurück:

{
  "error": {
    "message": "Human-readable description",
    "code": "error_code"
  }
}

Fehlerreferenz

400 Bad Request

Code	Ursache	Lösung
`invalid_json`	Der Request-Body ist kein gültiges JSON	Überprüfen Sie Ihre JSON-Syntax
`missing_model`	Feld `model` fehlt oder ist kein String	Fügen Sie `"model": "provider/name"` in Ihren Request-Body ein
`missing_input`	Feld `input` fehlt oder ist kein Objekt	Fügen Sie `"input": {...}` in Ihren Request-Body ein
`invalid_input`	Die Eingabe stimmt nicht mit dem Schema des Modells überein	Prüfen Sie in der API-Referenz des Modells die erforderlichen Felder und gültigen Werte
`model_not_found`	Die Modell-ID stimmt mit keinem verfügbaren Modell überein	In der Modelle-Seite finden Sie gültige Modell-IDs

401 Unauthorized

Code	Ursache	Lösung
`missing_api_key`	Kein `Authorization`-Header oder falsches Format	Fügen Sie `Authorization: Bearer sk-...` in Ihren Request ein
`invalid_api_key`	Schlüssel ist ungültig, deaktiviert oder abgelaufen	Erstellen Sie einen neuen Schlüssel oder reaktivieren Sie den vorhandenen unter Einstellungen → API Keys

402 Payment Required

Code	Ursache	Lösung
`insufficient_balance`	Ihr Guthaben ist für diesen Run zu niedrig	Laden Sie Ihr Guthaben unter Einstellungen → Credits auf

403 Forbidden

Code	Ursache	Lösung
`api_key_spend_limit_exceeded`	Das Lifetime-Ausgabenlimit des Schlüssels wurde erreicht	Erhöhen Sie das Ausgabenlimit unter Einstellungen → API Keys
`ip_not_allowed`	Ihre IP befindet sich nicht in der Whitelist des Schlüssels	Fügen Sie Ihre IP zur erlaubten Liste des Schlüssels hinzu oder entfernen Sie die Whitelist

429 Too Many Requests

Code	Ursache	Lösung
`RATE_LIMITED`	Zu viele Anfragen in einem kurzen Zeitfenster	Warten Sie und versuchen Sie es erneut. Siehe Rate Limits
`USAGE_EXCEEDED`	Das Nutzungskontingent des Schlüssels ist ausgeschöpft	Kontaktieren Sie den Support oder erstellen Sie einen neuen Schlüssel

404 Not Found

Code	Ursache	Lösung
`run_not_found`	Kein Run mit dieser ID für Ihr Konto	Prüfen Sie, ob die Run-ID korrekt ist und mit diesem API-Schlüssel erstellt wurde

500 Internal Server Error

Ein unerwarteter Fehler auf unserer Seite. Wenn das Problem weiterhin besteht, kontaktieren Sie support@runbase.net.

Fehlerbehandlung im Code

response=$(curl -s -w "\n%{http_code}" https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "google/nano-banana-2", "input": {"prompt": "test"}}')
 
http_code=$(echo "$response" | tail -1)
body=$(echo "$response" | head -1)
 
if [ "$http_code" -ne 201 ]; then
  echo "Error $http_code: $(echo $body | jq -r '.error.message')"
fi

Für 429-Fehler implementieren Sie exponentielles Backoff — warten Sie vor einem erneuten Versuch 1s, dann 2s, dann 4s.