Upscale (perbesar tile)

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"
    }
  ]
}

Memilih satu dari U1–U4 pada grid tugas induk (grid_image_url) untuk mendapatkan gambar tunggal. Ini diwujudkan dengan memotong dari 4 gambar yang ada; disusun lokal dan biasanya kembali seketika.

Item	Nilai
action	`UPSCALE`
Penagihan	`midjourney@upscale[-version][-speed]`
Wajib	`task_id` + `index`, atau `task_id` + `custom_id`
Opsional	`speed`, `metadata`

Parameter

Field	Tipe	Deskripsi
`task_id`	string	ID tugas induk (harus tugas SUCCESS imagine / variation / reroll, dll.)
`index`	int	Gambar ke berapa (U1–U4), rentang `1`–`4`; salah satu dari `index` / `custom_id`
`custom_id`	string	langsung berikan ID tombol untuk aksi terkait; salah satu dari `index` / `custom_id`; jika diset, matching `index` dilewati
`speed`	string	`relax` / `fast` / `turbo` (tidak berpengaruh, karena disusun lokal)
`metadata`	object	Metadata kustom

Contoh request

Dengan index:

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

Kirim tombol langsung:

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

Response

Submit mengembalikan task_id baru, biasanya SUCCESS dalam milidetik. Saat SUCCESS, image_urls berisi satu elemen (satu gambar), dan buttons berisi aksi lanjutan (zoom / inpaint / pan / variation, dll.).

Catatan

Tugas induk harus dalam status SUCCESS, jika tidak mengembalikan 400 (task is not in SUCCESS state).
index harus 1–4; di luar rentang mengembalikan 400. custom_id dan index saling eksklusif; jika keduanya dikirim, custom_id menang.
Langkah yang menghabiskan sumber daya adalah imagine; upscale hanya memilih dari gambar yang ada dan jarang gagal.
Gambar tunggal setelah upscale bisa dilanjutkan dengan Zoom / Inpaint / Variation.

HD upscale (perbesaran HD, menghasilkan gambar tunggal 2x)

Upscale biasa adalah penyusunan lokal — memotong salah satu dari 4 gambar yang sudah ada pada tugas induk, kembali seketika. Jika nantinya ingin melakukan operasi halus seperti zoom / inpaint pada gambar tunggal, disarankan beralih ke HD upscale: menjalankan perbesaran nyata, menghasilkan gambar tunggal HD 2x, selesai dalam sekitar 60–120s, dan gambar tunggal yang dihasilkan dapat lebih stabil mendukung zoom / inpaint lanjutan. HD upscale menentukan perintah perbesaran melalui custom_id, di mana versi imagine yang berbeda memerlukan perintah yang berbeda:

Perintah customId	Versi yang berlaku
`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

Contoh HD upscale

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

Setelah selesai, Anda mendapatkan tugas gambar tunggal HD 2x yang sesungguhnya, dan dapat melanjutkan dengan zoom / inpaint padanya.

Perbandingan dengan upscale biasa

Dimensi	Upscale biasa	HD upscale
Implementasi	Penyusunan lokal (pemotongan)	Pemrosesan perbesaran nyata
Durasi	Tingkat milidetik	Sekitar 60–120s
Output	Mengambil gambar ke-N dari 4 gambar	Gambar tunggal HD 2x
Lanjutan	zoom / inpaint / variation	zoom / inpaint lebih stabil

⚠️ pan tetap tidak tersedia

Bahkan gambar tunggal HD yang dihasilkan oleh HD upscale, operasi pan tetap akan ditolak (mengembalikan “permintaan generasi gambar tidak valid”) — ini adalah batasan Midjourney terhadap operasi pan itu sendiri, tidak terkait dengan cara perbesaran. Lihat selengkapnya di Pan.

Edits (edit gambar)Variation (variasi)

​Parameter

​Contoh request

​Response

​Catatan

​HD upscale (perbesaran HD, menghasilkan gambar tunggal 2x)

​Contoh HD upscale

​Perbandingan dengan upscale biasa

​⚠️ pan tetap tidak tersedia