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-ReferenzWebhooks
    Copy to LLM

    Webhooks

    Webhooks ermöglichen es Ihrem System, Job-Abschluss-Events zu empfangen, ohne kontinuierlich pollen zu müssen.


    Webhooks aktivieren

    Fügen Sie webhook_url in Ihrer Ausführungsanfrage ein:

    • POST /api/v1/models/run
    • POST /api/v1/apps/run

    Beispiel:

    {
      "model": "google/nano-banana",
      "input": { "prompt": "..." },
      "webhook_url": "https://your-app.com/webhooks/armox"
    }
    

    Zustellungsformat

    Armox sendet:

    • Methode: POST
    • Header: X-Armox-Signature: sha256=<signature>
    • Content-Type: application/json

    Payload-Struktur:

    {
      "event": "job.completed",
      "job": {
        "id": "job_456",
        "status": "completed",
        "output": {
          "outputImage": "https://..."
        },
        "completed_at": "2026-03-26T12:45:00.000Z"
      }
    }
    

    Signaturverifizierung (Node.js)

    import crypto from "crypto";
    
    export function verifyArmoxSignature(rawBody, signatureHeader, secret) {
      if (!signatureHeader || !signatureHeader.startsWith("sha256=")) return false;
    
      const received = signatureHeader.slice("sha256=".length);
      const expected = crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
    
      try {
        return crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
      } catch {
        return false;
      }
    }
    

    Signaturverifizierung (Python)

    Prompt Template
    import hmac
    import hashlib
    
    def verify_armox_signature(raw_body: bytes, signature_header: str, secret: str) -> bool:
        if not signature_header or not signature_header.startswith("sha256="):
            return False
    
        received = signature_header[len("sha256="):]
        expected = hmac.new(
            key=secret.encode("utf-8"),
            msg=raw_body,
            digestmod=hashlib.sha256
        ).hexdigest()
    
        return hmac.compare_digest(received, expected)

    Best Practices

    • Signatur vor der Verarbeitung des Payloads verifizieren
    • Rohen Request Body für die Signaturverifizierung verwenden
    • Events idempotent verarbeiten (Deduplizierung nach job.id)
    • Schnell 2xx zurückgeben
    • Aufwändige Verarbeitung in Hintergrund-Worker auslagern
    • Webhook-Handler retry-sicher gestalten

    Empfohlener Verarbeitungsablauf

    1. Webhook-Anfrage empfangen
    2. X-Armox-Signature verifizieren
    3. JSON-Payload validieren
    4. Job-Status in Ihrer Datenbank aktualisieren (Upsert)
    5. Nachgelagerten Workflow auslösen (Benachrichtigung, Asset-Indexierung usw.)
    6. Schnell 200 zurückgeben

    Polling + Webhooks kombiniert

    Für optimale Zuverlässigkeit verwenden Sie beides:

    • Webhook als primäre Event-Quelle
    • Periodisches Reconciliation-Polling als Fallback

    Polling-Muster finden Sie unter Jobs-Endpunkt.

    Verwandte Seiten

    • Jobs-Endpunkt
    • Fehler & Rate Limits
    ZurückKonto-Endpunkt
    WeiterFehler und Ratenlimits

    Bereit, deinen kreativen Workflow zu transformieren?

    Keine Kreditkarte erforderlich500 kostenlose Credits

    Auf dieser Seite

    Webhooks aktivierenZustellungsformatSignaturverifizierung (Node.js)Signaturverifizierung (Python)Best PracticesEmpfohlener VerarbeitungsablaufPolling + Webhooks kombiniertVerwandte Seiten