Langsung ke konten utama
POST
/
v1
/
midjourney
/
generations
/
modal
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/modal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
    "prompt": "replace the selected area with a red leather sofa",
    "mask_url": "https://example.com/mask.png",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/modal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
    "prompt": "replace the selected area with a red leather sofa",
    "mask_url": "https://example.com/mask.png",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Menyelesaikan tugas inpaint berstatus MODAL dengan menyediakan mask + prompt. Sistem mendeteksi mode otomatis berdasarkan ada tidaknya mask_url: ada mask_url → inpaint (repaint lokal); tanpa → outpaint (perluasan).
ItemNilai
actionMODAL
Penagihanmidjourney@modal[-speed]
Wajibtask_id
Opsionalprompt, mask_url, speed, metadata

​
Parameter

FieldDeskripsi
task_idID tugas lokal yang dikembalikan langkah inpaint (harus berstatus MODAL)
promptPrompt inpaint; jika kosong, mewarisi prompt tugas induk
mask_urlURL mask atau base64; wajib untuk inpaint (repaint lokal). Putih = area yang akan digambar ulang, transparan = pertahankan asli
speedrelax / fast / turbo
metadataMetadata opsional

​
Persyaratan mask

ItemRekomendasi
FormatPNG latar transparan (juga menerima data:image/png;base64,...)
ResolusiSebaiknya sama dengan gambar induk (sistem juga auto-resize)
Area putihArea yang akan digambar ulang; area transparan mempertahankan asli
Ukuran≤ 12 MiB per gambar
URLHarus dapat diakses publik (alamat privat diblokir oleh SSRF)

​
Contoh request

{
  "task_id": "task_01KQW1N9T6E3AHW6QZFDEK8M5C",
  "prompt": "replace the selected area with a red leather sofa",
  "mask_url": "https://example.com/mask.png",
  "speed": "fast"
}

​
Response

task_id tetap sama (tugas yang sama); statusnya berubah dari MODAL → SUBMITTED. Polling GET /v1/tasks/{task_id}; saat SUCCESS image_urls berisi 4 kandidat inpaint. Penagihan diselesaikan pada SUCCESS endpoint ini dan tidak ditagih ganda dengan langkah inpaint. Untuk harga per speed, konfigurasikan midjourney@modal-fast / midjourney@modal-turbo.