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-ReferenzApps-Endpunkt
    Copy to LLM

    Apps-Endpunkt

    Die Apps-API ermöglicht Ihnen, wiederverwendbare Workflow-Apps auszuführen, die in Armox Canvas erstellt wurden.

    Basispfade:

    • GET https://armox.ai/api/v1/apps
    • POST https://armox.ai/api/v1/apps/run

    GET /api/v1/apps

    Listet aktive Vorlagen-Apps und private Apps auf, auf die Ihr Benutzer Zugriff hat.

    Anfrage

    curl -X GET "https://armox.ai/api/v1/apps" \
      -H "Authorization: Bearer sk_live_your_key_here"
    

    Antwort

    Prompt Template
    {
      "object": "list",
      "data": [
        {
          "id": "app_123",
          "name": "Product Hero Creator",
          "description": "Generate hero product images from a short brief",
          "icon": "sparkles",
          "thumbnail_url": "https://...",
          "is_template": true,
          "brain_id": "brain_abc",
          "tags": ["marketing", "image"],
          "inputs": [
            {
              "id": "input_prompt",
              "label": "Prompt",
              "required": true
            }
          ]
        }
      ]
    }

    POST /api/v1/apps/run

    Führt einen App-Workflow aus und gibt einen asynchronen Job zurück.

    Request Body

    {
      "app_id": "app_123",
      "inputs": {
        "input_prompt": "Luxury perfume bottle, dramatic studio lighting, black background"
      },
      "webhook_url": "https://your-app.com/webhooks/armox"
    }
    

    Felder:

    • app_id (erforderlich): App-Bezeichner aus GET /api/v1/apps
    • inputs (optionales Objekt): Schlüssel-Wert-Eingabezuordnung nach Eingabe-ID
    • webhook_url (optional): Callback-URL

    Validierungsregeln

    • Die App muss existieren und aktiv sein
    • Der Benutzer muss Zugriff auf Nicht-Vorlagen-App-Ressourcen haben
    • Alle erforderlichen App-Eingaben müssen bereitgestellt werden

    Wenn erforderliche Eingaben fehlen, lautet die Antwort 400 mit:

    { "error": "Missing required inputs: Prompt" }
    

    Antwort (202)

    POST /api/v1/apps/run ist asynchron.

    {
      "id": "job_456",
      "object": "job",
      "status": "processing",
      "run_type": "app",
      "app_id": "app_123",
      "app_name": "Product Hero Creator",
      "credits_charged": 340,
      "created_at": "2026-03-26T12:20:00.000Z"
    }
    

    End-to-End-Beispiel

    1. Apps auflisten mit GET /api/v1/apps
    2. Eine App auswählen und ihre inputs prüfen
    3. Ausführen mit POST /api/v1/apps/run
    4. GET /api/v1/jobs/:id pollen bis zur Fertigstellung
    5. Ausgaben aus output_data.node_outputs lesen

    cURL

    curl -X POST "https://armox.ai/api/v1/apps/run" \
      -H "Authorization: Bearer sk_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "app_id": "app_123",
        "inputs": {
          "input_prompt": "Luxury perfume bottle, dramatic studio lighting, black background"
        }
      }'
    

    JavaScript

    const runResponse = await fetch("https://armox.ai/api/v1/apps/run", {
      method: "POST",
      headers: {
        Authorization: "Bearer sk_live_your_key_here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        app_id: "app_123",
        inputs: { input_prompt: "Luxury perfume bottle, dramatic studio lighting, black background" },
      }),
    });
    
    const job = await runResponse.json();
    console.log(job);
    

    Kosten und Credits

    Apps können intern mehrere Nodes ausführen. Credits werden abgezogen, sobald die App-Ausführung angenommen wird.

    Wenn der endgültige Job fehlschlägt, werden Credits gemäß der Job-Verarbeitungslogik erstattet.

    Verwandte Seiten

    • Jobs-Endpunkt
    • Webhooks
    • Fehler & Rate Limits
    ZurückModelle-Endpunkt
    WeiterJobs-Endpunkt

    Bereit, deinen kreativen Workflow zu transformieren?

    Keine Kreditkarte erforderlich500 kostenlose Credits

    Auf dieser Seite

    GET `/api/v1/apps`AnfrageAntwortPOST `/api/v1/apps/run`Request BodyValidierungsregelnAntwort (`202`)End-to-End-BeispielcURLJavaScriptKosten und CreditsVerwandte Seiten