Upscale (Kachel hochskalieren)

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

POST

midjourney

generations

upscale

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

Wählt eine Kachel U1–U4 aus dem Raster der Parent-Aufgabe (grid_image_url) und liefert ein Einzelbild. Dies wird durch Zuschnitt aus den vorhandenen 4 Bildern realisiert; lokal komponiert, meist sofortige Rückgabe.

Element	Wert
action	`UPSCALE`
Abrechnung	`midjourney@upscale[-version][-speed]`
Pflicht	`task_id` + `index`, oder `task_id` + `custom_id`
Optional	`speed`, `metadata`

Parameter

Feld	Typ	Beschreibung
`task_id`	string	Parent-Task-ID (muss ein SUCCESS-imagine / -variation / -reroll usw. sein)
`index`	int	Welche Kachel (U1–U4), Bereich `1`–`4`; entweder `index` oder `custom_id`
`custom_id`	string	Button-ID der entsprechenden Aktion direkt übergeben; entweder `index` oder `custom_id`; wenn gesetzt, wird `index`-Matching übersprungen
`speed`	string	`relax` / `fast` / `turbo` (ohne Wirkung, da lokal komponiert)
`metadata`	object	Benutzerdefinierte Metadaten

Request-Beispiele

Per index:

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 1,
  "speed": "fast"
}

Button direkt übergeben:

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample::1::xxxx"
}

Response

Das Absenden gibt eine neue task_id zurück, meist SUCCESS innerhalb von Millisekunden. Bei SUCCESS enthält image_urls ein einzelnes Element (ein Bild), und buttons enthält Folge-Aktionen (zoom / inpaint / pan / variation usw.).

Hinweise

Die Parent-Aufgabe muss im SUCCESS-Status sein, sonst gibt es 400 (task is not in SUCCESS state).
index muss 1–4 sein; außerhalb des Bereichs gibt es 400. custom_id und index schließen sich aus; bei beiden gewinnt custom_id.
Der ressourcenintensive Schritt ist imagine; upscale wählt nur aus vorhandenen Bildern und schlägt selten fehl.
Das einzelne Bild nach upscale kann mit Zoom / Inpaint / Variation fortgesetzt werden.

HD upscale (Hochskalieren in HD, liefert ein 2x-Einzelbild)

Das normale upscale ist eine lokale Komposition – es schneidet eines der bereits vorhandenen 4 Bilder der Parent-Aufgabe aus und liefert sofort zurück. Wenn du anschließend feinere Operationen wie zoom / inpaint am Einzelbild durchführen möchtest, empfiehlt sich stattdessen HD upscale: Es führt eine echte Hochskalierung durch und liefert ein 2x-Einzelbild in HD, fertig in etwa 60–120s. Das so erzeugte Einzelbild unterstützt anschließendes zoom / inpaint stabiler. HD upscale gibt den Hochskalierungs-Befehl über custom_id an; verschiedene imagine-Versionen entsprechen unterschiedlichen Befehlen:

customId-Befehl	Geeignete Version
`upsample_v5_2x`	v5 imagine
`upsample_v5_4x`	v5 imagine
`upsample_v6_2x_subtle`	v6 / v6.1 imagine
`upsample_v6_2x_creative`	v6 / v6.1 imagine
`upsample_v7_2x_subtle`	v7 / v8.1 imagine
`upsample_v7_2x_creative`	v7 / v8.1 imagine

HD-upscale-Beispiel

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample_v7_2x_subtle::1::xxxx"
}

Nach Abschluss erhältst du eine Aufgabe mit einem echten 2x-Einzelbild in HD, an der du weiter zoom / inpaint durchführen kannst.

Vergleich mit dem normalen upscale

Dimension	Normales upscale	HD upscale
Umsetzung	Lokale Komposition (Zuschnitt)	Echte Hochskalierungsverarbeitung
Dauer	Millisekundenbereich	etwa 60–120s
Ausgabe	N-tes von 4 Bildern	2x-Einzelbild in HD
Folge	zoom / inpaint / variation	zoom / inpaint stabiler

⚠️ pan weiterhin nicht verfügbar

Selbst beim HD-Einzelbild, das durch HD upscale erzeugt wurde, wird die pan-Operation weiterhin abgelehnt (Rückgabe „ungültige Bildgenerierungs-Anfrage”) – das ist eine Einschränkung von Midjourney für die pan-Operation selbst und hängt nicht von der Art der Hochskalierung ab. Siehe Schwenken.

Edits (Bildbearbeitung)Variation (Variation erzeugen)

​Parameter

​Request-Beispiele

​Response

​Hinweise

​HD upscale (Hochskalieren in HD, liefert ein 2x-Einzelbild)

​HD-upscale-Beispiel

​Vergleich mit dem normalen upscale

​⚠️ pan weiterhin nicht verfügbar