Fehler
Jeder Fehler, den diese API zurückgibt, was er bedeutet und was dagegen zu tun ist.
Fehlschläge eines Werkzeugs kommen als gewöhnliches Ergebnis mit isError: true und dem Grund als Text zurück. Probleme auf Protokollebene kommen als JSON-RPC-Fehler.
| Was passiert ist | Was du bekommst |
|---|---|
| Ungültiger, unbekannter oder widerrufener Schlüssel | HTTP 401, Rumpf {"error":"unauthorized"} — ohne Begründung |
| Schlüssel ganz ohne Bereiche | HTTP 403, Rumpf {"error":"no_scopes"} |
| Tarif ohne API | HTTP 403, verschachtelter Rumpf {"error":{"code":"tier_required","params":{"required":"studio",…}}} — anders als die flachen Rümpfe darüber stehen code und params innerhalb von error — API und MCP ab Studio; Tarif wechseln unter ikrames.com/pricing |
| Werkzeug nicht in deinem Bereich | -32602 · „Tool generate_image not found" |
| Ein Argument, das das Werkzeug nicht kennt | -32602 · unrecognized_keys |
| Eine Marke oder Datei ausserhalb deines Arbeitsbereichs | isError: true · „forbidden: …" |
| Nicht genug Guthaben | isError: true · insufficient_credits: N noetig, M vorhanden |
| Zu viele Anfragen | isError: true · rate_limited: in Ns erneut versuchen |
| Datei ohne C2PA-Signatur | isError: true · c2pa_unsigned: … |
Der Fehlertext des Servers ist deutsch.
Die Zeichenketten oben stehen genau so, wie sie zurückkommen, denn darauf würdest du abgleichen. Die maschinenlesbaren Teile — HTTP-Status, JSON-RPC-Code, isError — sind sprachunabhängig, und auf die solltest du verzweigen.
Unbekannte Argumente werden abgewiesen, nicht übergangen. Schick {"days": 7} an get_costs, und du bekommst einen Fehler, keine stille Gesamtsumme über alle Zeit. Für Agenten ist das am wichtigsten: ein Modell, das einen plausiblen Argumentnamen rät, soll erfahren, dass es falsch geraten hat, statt eine plausibel aussehende Antwort auf eine andere Frage zu bekommen.
Unbekannt und verboten sehen mit Absicht gleich aus. Eine Datei, die es nicht gibt, und eine Datei, die einem anderen Arbeitsbereich gehört, antworten beide „forbidden: unbekanntes Asset". Sie zu unterscheiden liesse einen Aufrufer durch Ausprobieren von IDs kartieren, was existiert.