API Pembuatan Gambar Midjourney v8.2 / Niji 7
Hasilkan gambar secara asinkron dengan midjourney-v8.2 dan midjourney-niji-7 melalui APIMaster.
Pembuatan gambar Midjourney v8.2 / Niji 7
Gunakan API gambar asinkron di https://apimaster.ai/v1 dengan midjourney-v8.2 atau midjourney-niji-7. ID model menentukan versinya; jangan menambahkan kolom pengganti versi.
Membuat tugas
POST https://apimaster.ai/v1/midjourney/generations
curl -s "https://apimaster.ai/v1/midjourney/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "midjourney-v8.2",
"prompt": "a quiet Japanese garden at dawn, cinematic composition",
"size": "16:9",
"speed": "relax"
}'
Untuk Niji 7, atur model ke midjourney-niji-7:
{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}
| Kolom | Tipe | Wajib | Deskripsi |
|---|---|---|---|
model |
string | Ya | midjourney-v8.2 atau midjourney-niji-7 |
prompt |
string | Ya | Deskripsi gambar, termasuk parameter Midjourney yang didukung |
size |
string | Tidak | Rasio aspek seperti 1:1 atau 16:9; default 1:1 |
speed |
string | Tidak | relax, fast, atau turbo; default relax |
image_urls |
string[] | Tidak | 1–20 URL gambar referensi; Data URL gambar yang didukung juga diterima |
iw |
number | Tidak | Bobot gambar referensi 0–3; memerlukan image_urls |
quality |
string | Tidak | 0.25, 0.5, 1, atau 2; tidak didukung oleh Niji 7 |
stylize / chaos / weird |
integer | Tidak | Rentang: 0–1000, 0–100, dan 0–3000 |
seed |
integer | Tidak | Seed acak 0–4294967295 |
negative_prompt |
string | Tidak | Konten yang dikecualikan |
sref / sw |
string / integer | Tidak | URL referensi gaya publik dan bobot 0–1000; sw memerlukan sref |
dref / dw |
string atau string[] / number | Tidak | URL referensi (hingga 20) dan bobot 0–100; dw memerlukan dref |
raw / tile / hd |
boolean | Tidak | Gaya raw, tiling, dan HD; tile dan hd hanya untuk v8.2 |
extra |
string | Tidak | String parameter yang didukung seperti --ar 16:9 --s 750; kolom terstruktur lebih diutamakan |
metadata |
object | Tidak | Metadata bisnis kustom |
repeat |
integer | Tidak | 2–40 untuk membuat beberapa tugas |
Niji 7 tidak mendukung quality, tile=true, atau hd=true. Kedua model menolak draft=true, cref, cw, stop, serta kolom permintaan version dan niji. style=raw dinormalisasi menjadi raw=true. Jangan gunakan --v atau --niji di dalam prompt atau extra untuk mengganti versi model.
Respons berisi ID batch dan ID tugas:
{
"id": "imagine_batch_xxxxxxxx",
"request_id": "req_xxxxxxxx",
"model": "midjourney-v8.2",
"status": "queued",
"data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}
Memeriksa status tugas
curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
-H "Authorization: Bearer YOUR_API_KEY"
Respons yang sudah selesai menyertakan URL gambar di data; tasks berisi setiap tugas anak:
{
"id": "imagine_batch_xxxxxxxx",
"status": "completed",
"progress": 100,
"data": [{"url": "https://example.com/generated.png"}],
"tasks": [{"task_id": "imagine_xxxxxxxx", "status": "completed", "progress": 100, "data": [{"url": "https://example.com/generated.png"}]}]
}
Lakukan polling selama statusnya queued atau processing. Jika gagal, baca tasks[].error dan jangan kirim ulang permintaan yang sama. Unduh URL yang dikembalikan secepatnya karena bisa kedaluwarsa.
Jika pengiriman mengembalikan 502 dengan header X-Task-ID, atau kueri mengembalikan pending_timeout, simpan ID tersebut dan terus periksa statusnya alih-alih mengirim ulang secara otomatis. Sebuah batch dapat berisi tugas yang berhasil sekaligus yang gagal; periksa tasks[] satu per satu. Disarankan melakukan polling setiap 15 detik.
Kesalahan dan harga
model dan prompt yang tidak kosong wajib diisi. Versi yang tidak didukung, rasio yang tidak valid, referensi yang tidak dapat diakses, dan parameter yang tidak didukung akan mengembalikan 400. 401 berarti kunci tidak valid, 402 berarti saldo tidak mencukupi, dan 429 berarti pembatasan laju. Lihat kartu Midjourney v8.2 dan kartu Niji 7 untuk harga dan rute terkini.
