BLACKFRIDAY ist da!

    40% Rabatt sichern
    Armox
    Armox Academy 📚
    Einführung
    Schnellstart-Anleitung
    Brains Verstehen
    Nodes
    KI-Modelle
    Der Leinwand-Editor
    LoRA trainieren
    Train MiniMax H3 LoRA
    Prompt Engineering
    Nano Banana ProFlux ModelleVideo-PromptsAudio-Prompts
    Text-Nodes
    Bild-Nodes
    Video-Nodes
    Audio-Nodes
    Upload-Nodes
    Tool-Nodes
    Academy.canvas3dNodes
    Nodes Verbinden
    Workflows Ausführen
    Was sind Apps?
    Deine Erste App Erstellen
    Apps Ausführen
    App-Ideen für Kreative
    Einführung in die API-Referenz
    AuthentifizierungModelle-EndpunktApps-EndpunktJobs-EndpunktKonto-EndpunktWebhooksFehler und Ratenlimits
    Die Galerie
    Download & Export
    KI-Chat Verwenden
    Brainstorming mit KI
    Text-Modelle
    GPT-5.4Gemini 3.1 ProClaude Opus 4.6GPT-5Gemini 2.5 FlashClaude 4.5 SonnetDeepSeek V3.1Grok 4Llama 3 70BLlama 3 8B
    Bild-Modelle
    Nano BananaNano Banana 2Nano Banana ProGPT Image 2.5Flux 2 ProKrea 2 LargeKrea 2 MediumFlux 2 FlexFlux 2 DevFlux 1.1 Pro UltraGrok ImagineFlux Kontext MaxFlux Kontext ProSeedream 4Seedream 4.5Wan 2.2 ImageQwen ImageQwen Image Edit AnglesStable Diffusion XLGrok 2 ImageGen4 Image
    Video-Modelle
    Kling V2.5 Turbo ProKling 2.6 ProGrok VideoVeo 3.1Veo 3.1 FastSeedance 1 ProSeedance 1 Pro FastSeedance 1 LiteSeedance 2.0Wan 2.6 I2VWan 2.6 T2VWan 2.5 I2VWan 2.5 T2VSora 2 ProSora 2Hailuo 2.3Hailuo 2.3 FastVideo-01 DirectorGen4 Aleph
    Audio-Modelle
    MusicGenMusic 1.5Music-01Lyria 2Speech-02 TurboSpeech-02 HDVoice CloningXTTS-v2
    Tool-Modelle
    Topaz Image UpscalerPrunaAI UpscaleCrystal UpscalerRemove BackgroundFace SwapImage FiltersProfessional HeadshotText RemovalInpaintAdd WatermarkVideo Upscale (Runway)Video Upscale (Topaz)Video Upscale (Bytedance)Lip Sync ProAuto CaptionReplace CharacterMotion Transfer
    Academy.models3d
    Hunyuan3D V3
    Social-Media-Inhalte
    Produktfotografie
    Marketing-Kampagnen
    Videoproduktion
    Audio & Musik
    Mehrstufige Workflows
    Bild-zu-Bild
    Konsistenter Stil
    Credit-Optimierung
    Häufige Fehler
    Tastaturkürzel
    Beispiel-Galerie
    Prompt-Bibliothek
    Seedance 2.0 for AEC
    Enterprise-Übersicht
    Admin-Dashboard
    Credits Anfordern
    FAQ
    Credits Verstehen
    Fehlerbehebung
    API-ReferenzEinführung in die API-ReferenzFehler und Ratenlimits
    Copy to LLM

    Fehler & Rate Limits

    Die öffentliche Armox-API verwendet standardmäßige HTTP-Statuscodes und ein einheitliches JSON-Fehlerformat.

    Fehlerantwort-Format

    { "error": "Human-readable message" }
    

    Beispiele:

    { "error": "Invalid API key" }
    
    { "error": "Insufficient credits. Required 1000, available 200" }
    

    Fehlercodes

    CodeBedeutungTypische Ursache
    400Bad RequestUngültiger Payload, fehlendes Pflichtfeld, ungültiges Modell
    401UnauthorizedFehlender oder ungültiger Bearer-API-Schlüssel
    402Payment RequiredUnzureichende Credits
    403ForbiddenPlan-/Zugangsbeschränkungen
    404Not FoundRessource/Job/App nicht gefunden
    409ConflictJob kann im aktuellen Status nicht storniert werden
    429Too Many RequestsSchlüsselbasiertes Rate Limit überschritten
    500Internal Server ErrorUnerwarteter Backend-Fehler

    Rate Limits

    Rate Limiting wird pro API-Schlüssel mit einem rollierenden 60-Sekunden-Fenster durchgesetzt.

    Jede erfolgreiche authentifizierte Antwort enthält:

    • X-RateLimit-Limit
    • X-RateLimit-Remaining
    • X-RateLimit-Reset

    Wenn das Limit überschritten wird, gibt die API zurück:

    • Status 429
    • Fehler-Body { "error": "Rate limit exceeded" }
    • Retry-After: 60-Header

    Umgang mit 429-Antworten

    Empfohlene Strategie:

    1. Retry-After-Header auslesen
    2. Vor dem erneuten Versuch warten
    3. Exponentielles Backoff mit Jitter bei wiederholten 429-Antworten verwenden
    4. Synchronisierte Wiederholungsversuche über Worker hinweg vermeiden

    JavaScript Retry-Beispiel

    async function requestWithRetry(url, options, retries = 3) {
      for (let attempt = 0; attempt <= retries; attempt += 1) {
        const response = await fetch(url, options);
        if (response.status !== 429) return response;
    
        const retryAfter = Number(response.headers.get("Retry-After") || 2);
        await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
      }
    
      throw new Error("Exceeded retry attempts");
    }
    

    Credits und Abrechnungsverhalten

    • Credits werden bei Annahme einer Ausführung belastet
    • Fehlgeschlagene Jobs werden durch den Ausführungsablauf erstattet
    • Nutzung überwachen über GET /api/v1/account

    Häufige Produktionsfehler

    • Invalid API key: falscher/abgelaufener/widerrufener Schlüssel
    • Insufficient credits ...: Credits aufladen oder Ausführungskosten reduzieren
    • Rate limit exceeded: Backoff + Warteschlange hinzufügen

    Debugging-Checkliste

    • Überprüfen, ob Authorization: Bearer ... vorhanden ist
    • Endpunkt-Pfad und Methode überprüfen
    • Request-IDs/Job-IDs in Ihrer App protokollieren
    • Response-Header für Rate-Limit-Beobachtbarkeit erfassen
    • Fehlgeschlagene Payloads für erneute Verarbeitung speichern

    Verwandte Seiten

    • Authentifizierung
    • Jobs-Endpunkt
    • Account-Endpunkt
    ZurückWebhooks
    WeiterDie Galerie

    Bereit, deinen kreativen Workflow zu transformieren?

    Keine Kreditkarte erforderlich500 kostenlose Credits

    Auf dieser Seite

    Fehlerantwort-FormatFehlercodesRate LimitsUmgang mit 429-AntwortenJavaScript Retry-BeispielCredits und AbrechnungsverhaltenHäufige ProduktionsfehlerDebugging-ChecklisteVerwandte Seiten