Zum Hauptinhalt springen
Base URL: https://api.apimart.aiAuth: Authorization: Bearer <token>Die neuen /v1/midjourney/...-Routen injizieren model=midjourney automatisch; Sie müssen model im Request-Body nicht angeben.

​
Schnellstart

# 1. Imagine-Auftrag einreichen
curl -X POST https://api.apimart.ai/v1/midjourney/generations \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a cute cat, watercolor style --ar 16:9"}'

# 2. Über die einheitliche Task-API pollen, bis status=completed
curl https://api.apimart.ai/v1/tasks/task_01JWXXXX \
  -H "Authorization: Bearer <token>"

# 3. Bild 1 hochskalieren
curl -X POST https://api.apimart.ai/v1/midjourney/generations/upscale \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task_01JWXXXX", "index": 1}'

​
API-Übersicht

Die vollständigen Felder, Beispiele und Hinweise jeder Funktion finden Sie auf der jeweiligen Unterseite.
FunktionPfadDoku
Text-zu-Bild (Standard)POST /v1/midjourney/generationsImagine
Text-zu-Bild (explizit)POST /v1/midjourney/generations/imagineImagine
Mehrbild-BlendPOST /v1/midjourney/generations/blendBlend
Bild zu TextPOST /v1/midjourney/generations/describeDescribe
BildbearbeitungPOST /v1/midjourney/generations/editsEdits
Kachel hochskalierenPOST /v1/midjourney/generations/upscaleUpscale
VariationPOST /v1/midjourney/generations/variationVariation
Starke VariationPOST /v1/midjourney/generations/high-variationHigh Variation
Schwache VariationPOST /v1/midjourney/generations/low-variationLow Variation
Neu generierenPOST /v1/midjourney/generations/rerollReroll
Zoom OutPOST /v1/midjourney/generations/zoomZoom
PanPOST /v1/midjourney/generations/panPan
InpaintPOST /v1/midjourney/generations/inpaintInpaint
Modal (Parameter ergänzen)POST /v1/midjourney/generations/modalModal
Bild-zu-VideoPOST /v1/midjourney/generations/videoVideo
Reshape (stark / schwach)POST /v1/midjourney/generations/remix-strong · /remix-subtleRemix
AufgabenabfrageGET /v1/tasks/{task_id} · /v1/midjourney/{task_id}Aufgabe abfragen
Siehe auch: Best Practices (Polling / Retries / Fehlersuche) · End-to-End-Workflows (curl-Walkthroughs + Client-Wrapper)

​
End-to-End-Ablauf

​
Fehler

​
Fehler-Response-Format

{
  "error": {
    "type": "invalid_request_error",
    "message": "prompt is required"
  }
}

​
Häufige Fehler

HTTPtypeBedeutung
400invalid_request_errorUngültige Parameter
401authentication_errorUngültiger API-Key
402payment_requiredGuthaben nicht ausreichend
404not_foundAufgabe nicht gefunden
429rate_limit_errorRate-Limit erreicht
500internal_errorServerfehler

​
Task-Fehler

Häufige fail_reason-Werte:
  • Banned prompt detected — Verbotener Prompt-Inhalt
  • Task timeout — Task-Timeout (Auto-Refund nach 30+ Minuten)
  • No available upstream — Dienst vorübergehend nicht verfügbar, später erneut versuchen

​
Abrechnung

Der einheitliche Modellname für neue MJ-Routen ist midjourney. Abrechnungs-Keys werden aus action, version und speed generiert. Übliche Match-Reihenfolge: 
midjourney@<action>-<version>-<speed>
-> midjourney@<action>-<version>
-> midjourney@<action>-<speed>
-> midjourney@<action>
-> midjourney
ActionAbrechnungsnameHinweise
Imaginemidjourney@imagine[-version][-speed]Text-zu-Bild / bildgesteuert
Blendmidjourney@blend[-speed]Mehrbild-Blend
Describemidjourney@describe[-speed]Bild zu Text
Editsmidjourney@edits[-speed]Bildbearbeitung
Upscalemidjourney@upscale[-version][-speed]Hochskalieren
Variationmidjourney@variation[-version][-speed]Variation
High Variationmidjourney@high_variation[-version][-speed]Starke Variation
Low Variationmidjourney@low_variation[-version][-speed]Schwache Variation
Rerollmidjourney@reroll[-version][-speed]Neu generieren
Zoommidjourney@zoom[-version][-speed]Zoom Out / Outpaint
Panmidjourney@pan[-version][-speed]Pan-Outpaint
Inpaintmidjourney@inpaint[-version][-speed]Inpaint-Einstieg
Modalmidjourney@modal[-speed]Inpaint-Folgeparameter
Videomidjourney@video / midjourney@video-720pBild-zu-Video, berechnet × batch_size
Remix Strongmidjourney@remix_strong[-speed]Starkes Reshape (nur v8.1 / v8.2)
Remix Subtlemidjourney@remix_subtle[-speed]Schwaches Reshape (nur v8.1 / v8.2)
Hinweise:
  • speed=relax oder weggelassen ergibt kein Speed-Suffix; fast / turbo fügen das passende Suffix hinzu.
  • Hauptversionen normalisieren zu v8.2, v8.1, v7, v6.1, v5.2, v5.1.
  • niji=true + version=7/6 normalisiert zu niji7 / niji6.
Siehe Konsolen-Preisliste. Fehlgeschlagene Aufträge werden vollständig erstattet.