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

    Jobs-Endpunkt

    Jede Modell-/App-Ausführung erstellt ein Job-Objekt.

    Verwenden Sie die Jobs-Endpunkte, um:

    • kürzliche Jobs aufzulisten
    • einen einzelnen Job nach ID abzurufen
    • stornierbare Jobs abzubrechen

    Basispfade:

    • GET /api/v1/jobs
    • GET /api/v1/jobs/:id
    • POST /api/v1/jobs/:id/cancel

    Job-Lebenszyklus

    Jobs verwenden folgende Status:

    • pending
    • processing
    • completed
    • failed
    • cancelled
    flowchart LR
      pending --> processing
      processing --> completed
      processing --> failed
      pending --> cancelled
      processing --> cancelled
    

    Endgültige Status sind:

    • completed
    • failed
    • cancelled

    GET /api/v1/jobs

    Listet kürzliche Jobs des authentifizierten Benutzers auf.

    Abfrageparameter

    • limit (optional): 1-100, Standard 20

    Anfrage

    curl -X GET "https://armox.ai/api/v1/jobs?limit=20" \
      -H "Authorization: Bearer sk_live_your_key_here"
    

    Antwort

    Prompt Template
    {
      "object": "list",
      "data": [
        {
          "id": "job_123",
          "run_type": "model",
          "model_id": "google/nano-banana",
          "app_id": null,
          "status": "completed",
          "input_data": { "input": { "prompt": "..." } },
          "output_data": { "outputImage": "https://..." },
          "error_message": null,
          "credits_charged": 70,
          "created_at": "2026-03-26T12:30:00.000Z",
          "completed_at": "2026-03-26T12:30:03.000Z"
        }
      ]
    }

    GET /api/v1/jobs/:id

    Gibt einen bestimmten Job zurück.

    Anfrage

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

    Antwort

    {
      "object": "job",
      "id": "job_123",
      "run_type": "model",
      "model_id": "google/nano-banana",
      "app_id": null,
      "status": "completed",
      "input_data": { "input": { "prompt": "..." } },
      "output_data": { "outputImage": "https://..." },
      "error_message": null,
      "credits_charged": 70,
      "created_at": "2026-03-26T12:30:00.000Z",
      "completed_at": "2026-03-26T12:30:03.000Z",
      "webhook_delivered": true
    }
    

    POST /api/v1/jobs/:id/cancel

    Versucht, einen ausstehenden oder in Verarbeitung befindlichen Job abzubrechen.

    Anfrage

    curl -X POST "https://armox.ai/api/v1/jobs/job_123/cancel" \
      -H "Authorization: Bearer sk_live_your_key_here"
    

    Erfolgsantwort

    {
      "id": "job_123",
      "object": "job",
      "status": "cancelled",
      "cancelled_at": "2026-03-26T12:35:00.000Z"
    }
    

    Wenn der Job nicht mehr storniert werden kann, gibt die API möglicherweise 409 zurück.


    Polling-Muster

    JavaScript

    Prompt Template
    async function waitForJob(jobId, apiKey) {
      while (true) {
        const response = await fetch(`https://armox.ai/api/v1/jobs/${jobId}`, {
          headers: { Authorization: `Bearer ${apiKey}` },
        });
    
        const job = await response.json();
        if (["completed", "failed", "cancelled"].includes(job.status)) {
          return job;
        }
    
        await new Promise((resolve) => setTimeout(resolve, 2000));
      }
    }

    Python

    Prompt Template
    import time
    import requests
    
    def wait_for_job(job_id, api_key):
        while True:
            response = requests.get(
                f"https://armox.ai/api/v1/jobs/{job_id}",
                headers={"Authorization": f"Bearer {api_key}"}
            )
            job = response.json()
    
            if job.get("status") in ["completed", "failed", "cancelled"]:
                return job
    
            time.sleep(2)

    Credits und Fehlschläge

    • Credits werden bei Annahme einer Ausführung belastet
    • Fehlgeschlagene Jobs werden durch den Job-Executor-Ablauf erstattet
    • Stornierte Jobs folgen der Stornierungs- und Credit-Logik der Plattform

    Verwandte Seiten

    • Models-Endpunkt
    • Apps-Endpunkt
    • Webhooks
    ZurückApps-Endpunkt
    WeiterKonto-Endpunkt

    Bereit, deinen kreativen Workflow zu transformieren?

    Keine Kreditkarte erforderlich500 kostenlose Credits

    Auf dieser Seite

    Job-LebenszyklusGET `/api/v1/jobs`AbfrageparameterAnfrageAntwortGET `/api/v1/jobs/:id`AnfrageAntwortPOST `/api/v1/jobs/:id/cancel`AnfrageErfolgsantwortPolling-MusterJavaScriptPythonCredits und FehlschlägeVerwandte Seiten