Zum Hauptinhalt springen
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "mj-v7",
  "prompt": "A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500",
  "model_params": {
    "speed": "fast"
  }
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-mjv7",
  "model": "mj-v7",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}
Midjourney verfügt über ein integriertes Moderationssystem. Wenn einige generierte Bilder durch die Moderation gefiltert werden, können die für diese Anfrage verbrauchten Credits nicht erstattet werden. Bitte achten Sie darauf, dass Ihre Prompts den Inhaltsrichtlinien entsprechen.

Autorisierungen

​
Authorization
string
header
erforderlich

Alle Endpunkte erfordern Bearer Token Authentifizierung

API Key erhalten:

Besuchen Sie die API Key Verwaltungsseite um Ihren API Key zu erhalten

Zum Request-Header hinzufuegen:

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
model
enum<string>
Standard:mj-v7
erforderlich

Modellname

Verfügbare Optionen:
mj-v7
​
prompt
string
erforderlich

Prompt, unterstuetzt alle nativen Midjourney V7-Parameter (z.B. --ar 16:9 --s 500).

Bild-zu-Bild: Platzieren Sie Bild-URLs am Anfang des Prompts. Unterstuetzte Formate: .png, .gif, .webp, .jpg, .jpeg

Bild-zu-Bild-Regeln:

  • 1 Bild + kein Text = ungueltig (gibt Fehler zurueck)
  • 1 Bild + Textbeschreibung = gueltig
  • 2+ Bilder + kein Text = gueltig
  • 2+ Bilder + Textbeschreibung = gueltig
Maximum string length: 8192
Beispiel:

"A cinematic shot of a Maine Coon cat on a neon-lit balcony --ar 16:9 --s 500"

​
model_params
object

Modellparameter

​
callback_url
string<uri>

HTTPS-Callback-URL fuer Aufgabenabschluss

Callback-Zeitpunkt:

  • Ausgeloest bei Abschluss, Fehler oder Abbruch der Aufgabe
  • Nach Abrechnungsbestaetigung gesendet

Sicherheitsbeschraenkungen:

  • Nur HTTPS-Protokoll
  • Callbacks an private IPs verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x usw.)
  • URL-Laenge max 2048 Zeichen

Callback-Mechanismus:

  • Timeout: 10 Sekunden
  • Bis zu 3 Wiederholungen (nach 1s/2s/4s)
  • Antwortformat entspricht der Aufgabenabfrage
  • 2xx-Statuscode = erfolgreich; andere loesen Wiederholungen aus
Beispiel:

"https://your-domain.com/webhooks/image-task-completed"

Antwort

Aufgabe erfolgreich erstellt

​
created
integer

Zeitstempel der Aufgabenerstellung

Beispiel:

1757165031

​
id
string

Aufgaben-ID

Beispiel:

"task-unified-1757165031-mjv7"

​
model
string

Tatsaechlich verwendeter Modellname

Beispiel:

"mj-v7"

​
object
enum<string>

Aufgabenobjekttyp

Verfügbare Optionen:
image.generation.task
​
progress
integer

Aufgabenfortschritt in Prozent (0-100)

Erforderlicher Bereich: 0 <= x <= 100
Beispiel:

0

​
status
enum<string>

Aufgabenstatus

Verfügbare Optionen:
pending,
processing,
completed,
failed
Beispiel:

"pending"

​
task_info
object

Asynchrone Aufgabeninformation

​
type
enum<string>

Aufgabenausgabetyp

Verfügbare Optionen:
text,
image,
audio,
video
Beispiel:

"image"

​
usage
object

Nutzungs- und Abrechnungsinformationen