API- und MCP-Verbindungen prüfen
Unterscheide API-Schlüssel von OAuth, behebe Rechte- und Uploadprobleme und stelle unklare Anfragen ohne Umgehung der Sicherungen wieder her.
Auf dieser Seite
Richtige Verbindung und Zugangsdaten nutzen
| Integration | Adresse | Authentifizierung |
|---|---|---|
| Öffentliche API | https://api.animgen.com/v1 |
Bearer-API-Schlüssel mit passenden Rechten |
| Offizielles Remote-MCP | https://api.animgen.com/mcp |
OAuth über kompatiblen Streamable-HTTP-Client |
| Tool-Manifest | https://animgen.com/mcp/tools.json |
Öffentliche Dokumentation, keine MCP-Verbindung |
MCP ist als öffentliche Beta verfügbar. Öffnen im Browser ohne OAuth kann eine Authentifizierungsantwort liefern; es ist keine normale HTML-Seite. Das allein beweist keinen Ausfall.
Ersetze MCP-OAuth nicht durch API-Schlüssel, nutze kein Website-Anmeldetoken als API-Schlüssel und ergänze keinen erfundenen /sse-Pfad. Folge der Client-Einrichtung.
Anmeldung klappt, Tools scheitern
Prüfe verifiziertes AnimGen-Konto, nicht pausierten Entwicklerzugang und erteilte Rechte. Prüfe danach Guthaben für kostenpflichtige Generierung.
Widerrufene Freigabe, fehlende Berechtigung oder inkompatibler OAuth-Ablauf sind unabhängig vom Guthaben zu lösen. Verbinde gegebenenfalls offiziell neu; deaktiviere weder PKCE noch Redirect-Validierung zur Fehlerumgehung.
Nutze list_models zuerst als Lesetest. Erfolg bestätigt Verbindung und Leserecht, nicht Uploadfähigkeit, Generierungsfreigabe oder vollständige Ausgabequalität.
Upload oder Download unvollständig
Der entfernte Server liest keinen lokalen Pfad. Nach prepare_image_upload muss eine freigegebene Client-Funktion echte Bytes senden; complete_image_upload muss eine gültige Datei-ID liefern.
Auch download_asset liefert nur Metadaten und temporäre URL, keine schon gespeicherte Datei. Lade Bytes ohne API-/OAuth-Zugangsdaten weiterzugeben. Fehlen Client-Fähigkeiten, benenne die Grenze und nutze eine erlaubte unterstützte Alternative.
Kalkulations- und Ausgabenablehnungen
| Code | Nächste Aktion |
|---|---|
SPEND_CONFIRMATION_REQUIRED |
Konkrete Freigabe und nötige Sicherung einholen |
QUOTE_EXPIRED |
Neu kalkulieren und Betrag prüfen |
QUOTE_MISMATCH / QUOTE_CHANGED |
Parameter-/Preisänderung abgleichen und Freigabe holen |
QUOTE_ALREADY_USED |
Ursprüngliche Operation wiederfinden, Kalkulation nicht neu nutzen |
CREDIT_LIMIT_EXCEEDED |
Stoppen; Umfang reduzieren oder anderes Limit genehmigen lassen |
INSUFFICIENT_CREDITS |
Guthabenproblem erklären, nicht automatisch kaufen |
quote_id und max_credits stehen als MCP-Argumente neben request, nicht im öffentlichen API-Anfragetext. Ein Limit pro Operation ist kein Sitzungsbudget. Siehe Ausgabenschutz.
Unklare Erstellung sicher wiederherstellen
Behalte Anfrage, Idempotenzschlüssel, Konto und Zugangsdatenidentität: API-Schlüssel-ID bei API, OAuth-Client bei MCP. Gehe bei Schlüssel-/Client-Wechsel nicht von mitwandernder Deduplizierung aus.
Frage einen bekannten Auftrag vor erneuter Erstellung ab. Beachte Wiederholbarkeit und vorhandenes API-Retry-After; strukturierte MCP-Fehler enthalten diesen Header nicht garantiert. Begrenze Wiederholungen und lokales Warten.
Lokaler Timeout bricht den entfernten Auftrag nicht ab. Endgültiger Fehler kann Teilausgaben und Kosten enthalten. Übermittle Support privat Anfrage-/Auftrags-IDs, Zeitpunkte, Code, Client-Typ und Phase, ohne Geheimnisse oder signierte Links.
War diese Seite hilfreich?
Es werden keine Suchbegriffe, Codes oder Freitexte erfasst. Dieser Schalter steuert nur Dokumentationsinteraktionen; allgemeine Website-Analysen folgen der Datenschutzerklärung. Datenschutzerklärung