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

    API-Referenz Einführung

    Die öffentliche Armox-API ermöglicht allen Nutzern, dieselben Modelle und App-Workflows auszuführen, die Armox Canvas antreiben – direkt aus Ihrem Backend, Ihren Automatisierungen und internen Tools.

    Nutzen Sie diese Seite als Ausgangspunkt und besuchen Sie anschließend die jeweiligen Endpunkt-Seiten für vollständige Request-/Response-Referenzen und Produktionsmuster.


    Wer kann diese API nutzen

    Der Zugang zur öffentlichen API ist in allen Plänen verfügbar, einschließlich Free, Hobby, Pro, Ultra, der bisherigen Pläne Agency und Master, Business und Enterprise. Ein gültiger API-Schlüssel ist erforderlich. Generierungen nutzen die Credits und Limits Ihres Plans.

    Basis-URL

    Verwenden Sie die Armox-Produktions-API-Basis-URL für alle Endpunkte:

    https://armox.ai/api/v1


    Authentifizierung

    Alle API-Endpunkte erfordern einen Bearer-API-Schlüssel im Authorization-Header:

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

    Schlüssel verwalten Sie unter:

    • https://armox.ai/app/settings/api-keys

    Für die vollständige Schlüsselverwaltung und Sicherheitspraktiken siehe:

    • Authentifizierung

    API-Abschnitte

    • Authentifizierung
    • Models-Endpunkt
    • Apps-Endpunkt
    • Jobs-Endpunkt
    • Account-Endpunkt
    • Webhooks
    • Fehler & Rate Limits

    Schnellstart in 5 Schritten

    1. Erstellen Sie einen API-Schlüssel unter /app/settings/api-keys
    2. Rufen Sie GET /api/v1/models auf, um gültige Modell-IDs und Einstellungen zu entdecken
    3. Führen Sie ein Modell aus mit POST /api/v1/models/run
    4. Falls die Antwort asynchron ist (status: "processing"), pollen Sie GET /api/v1/jobs/:id
    5. Optional: Fügen Sie webhook_url hinzu, um Abschluss-Events zu empfangen

    Ihre erste Anfrage

    cURL

    Prompt Template
    curl -X POST "https://armox.ai/api/v1/models/run" \
      -H "Authorization: Bearer sk_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "google/nano-banana",
        "input": {
          "prompt": "Turn this into a cinematic night street photo with neon signs and reflections.",
          "image_input": ["https://example.com/reference-image.jpg"],
          "aspect_ratio": "match_input_image",
          "output_format": "png"
        }
      }'

    JavaScript (fetch)

    Prompt Template
    const response = await fetch("https://armox.ai/api/v1/models/run", {
      method: "POST",
      headers: {
        Authorization: "Bearer sk_live_your_key_here",
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        model: "google/nano-banana",
        input: {
          prompt: "Turn this into a cinematic night street photo with neon signs and reflections.",
          image_input: ["https://example.com/reference-image.jpg"],
          aspect_ratio: "match_input_image",
          output_format: "png",
        },
      }),
    });
    
    const data = await response.json();
    console.log(data);

    Python

    Prompt Template
    import requests
    
    response = requests.post(
        "https://armox.ai/api/v1/models/run",
        headers={
            "Authorization": "Bearer sk_live_your_key_here",
            "Content-Type": "application/json",
        },
        json={
            "model": "google/nano-banana",
            "input": {
                "prompt": "Turn this into a cinematic night street photo with neon signs and reflections.",
                "image_input": ["https://example.com/reference-image.jpg"],
                "aspect_ratio": "match_input_image",
                "output_format": "png",
            },
        },
    )
    
    print(response.status_code)
    print(response.json())

    Go

    Prompt Template
    package main
    
    import (
      "bytes"
      "encoding/json"
      "fmt"
      "net/http"
    )
    
    func main() {
      payload := map[string]any{
        "model": "google/nano-banana",
        "input": map[string]any{
          "prompt": "Turn this into a cinematic night street photo with neon signs and reflections.",
          "image_input": []string{"https://example.com/reference-image.jpg"},
          "aspect_ratio": "match_input_image",
          "output_format": "png",
        },
      }
    
      b, _ := json.Marshal(payload)
      req, _ := http.NewRequest("POST", "https://armox.ai/api/v1/models/run", bytes.NewBuffer(b))
      req.Header.Set("Authorization", "Bearer sk_live_your_key_here")
      req.Header.Set("Content-Type", "application/json")
    
      client := &http.Client{}
      resp, _ := client.Do(req)
      defer resp.Body.Close()
    
      fmt.Println("Status:", resp.StatusCode)
    }

    Häufige nächste Schritte

    • Authentifizierung und Schlüsselsicherheit lernen: Authentifizierung
    • Synchrone/asynchrone Modellausführungen verstehen: Models-Endpunkt
    • App-Workflow-Automatisierungen erstellen: Apps-Endpunkt
    • Polling und Stornierung implementieren: Jobs-Endpunkt
    • Produktions-Webhooks konfigurieren: Webhooks
    • Fehler und 429-Wiederholungen behandeln: Fehler & Rate Limits

    Sicherheitsgrundlagen

    • API-Schlüssel nur serverseitig verwenden
    • Schlüssel regelmäßig rotieren
    • Separate Schlüssel für Entwicklung/Staging/Produktion verwenden
    • Webhook-Signaturen vor der Verarbeitung von Payloads überprüfen

    Produktionshinweise

    • Speichern Sie die zurückgegebene job.id in Ihrer Datenbank
    • Pollen Sie entweder /jobs/:id oder verarbeiten Sie Webhook-Events
    • Speichern Sie die resultierenden Ausgabe-URLs für Ihre App-Oberfläche
    ZurückApp-Ideen für Kreative
    WeiterAuthentifizierung

    Bereit, deinen kreativen Workflow zu transformieren?

    Keine Kreditkarte erforderlich500 kostenlose Credits

    Auf dieser Seite

    Wer kann diese API nutzenBasis-URLAuthentifizierungAPI-AbschnitteSchnellstart in 5 SchrittenIhre erste AnfragecURLJavaScript (fetch)PythonGoHäufige nächste SchritteSicherheitsgrundlagenProduktionshinweise