Midjourney API ile Başlayın

Temel kavramı anlayın

MidJourney API Discord düğmesi etkileşimlerini simüle eder. Tipik REST API’lerinden farklı olarak, bir durum makinesi olarak çalışır; her işlem bir sonraki adım için yeni düğmeler döndürür.

4 temel API

API	Amaç	Ne Zaman Kullanılır
`POST /mj/submit/imagine`	Metinden görüntü oluşturma	Tüm iş akışları için başlangıç noktası
`GET /mj/task/\{id\}/fetch`	Görev durumunu sorgulayın ve düğmeleri alın	Her gönderimden sonra (tamamlanana kadar yoklayın)
`POST /mj/submit/action`	Bir düğmeye tıklayın (upscale, vary, zoom vb.)	Bir görüntü üzerinde işlem yapmak istediğinizde
`POST /mj/submit/modal`	Ek girdi gönderin	Yalnızca durum şu olduğunda `MODAL`

Tam iş akışı diyagramı

┌─────────────────────────────────────────────────────────────────────────────┐
│                         MIDJOURNEY API WORKFLOW                             │
└─────────────────────────────────────────────────────────────────────────────┘

  ┌──────────────────┐
  │  POST /submit/   │  ← Step 1: Submit prompt, get task_id
  │     imagine      │
  └────────┬─────────┘
           │ Returns: { "result": "task_id_1" }
           ▼
  ┌──────────────────┐
  │ GET /task/{id}/  │  ← Step 2: Poll until status = "SUCCESS"
  │      fetch       │
  └────────┬─────────┘
           │ Returns: imageUrl + buttons[] (U1,U2,U3,U4,V1,V2,V3,V4,🔄)
           ▼
  ┌──────────────────┐
  │  POST /submit/   │  ← Step 3: Click a button using customId
  │     action       │
  └────────┬─────────┘
           │ Returns: { "result": "task_id_2" }
           ▼
  ┌──────────────────┐
  │ GET /task/{id}/  │  ← Step 4: Poll the new task
  │      fetch       │
  └────────┬─────────┘
           │
           ├─── status = "SUCCESS" → Done! Get imageUrl
           │
           └─── status = "MODAL" → Need additional input (see Step 5)
                      │
                      ▼
           ┌──────────────────┐
           │  POST /submit/   │  ← Step 5: Submit mask/prompt for special operations
           │      modal       │
           └────────┬─────────┘
                    │ Returns: { "result": "task_id_3" }
                    ▼
           ┌──────────────────┐
           │ GET /task/{id}/  │  ← Step 6: Poll until SUCCESS
           │      fetch       │
           └──────────────────┘

Temel kavram: Düğmeler ve customId

Her başarılı görev bir buttons dizisi döndürür. Her düğmenin, sonraki eylemi tetiklemek için kullandığınız bir customId değeri vardır. Şuradan örnek yanıt /mj/task/\{id\}/fetch:

{
  "status": "SUCCESS",
  "imageUrl": "https://api.cometapi.com/mj/image/xxx",
  "buttons": [
    { "customId": "MJ::JOB::upsample::1::abc123", "label": "U1" },
    { "customId": "MJ::JOB::upsample::2::abc123", "label": "U2" },
    { "customId": "MJ::JOB::variation::1::abc123", "label": "V1" },
    { "customId": "MJ::JOB::reroll::0::abc123", "emoji": "🔄" }
  ]
}

customId sabit bir değer değildir. Her görev için değişir. Her zaman buttons dizisinden alın.

Aşamaya göre düğme başvurusu

IMAGINE sonrası (4’lü ızgara görüntüsü)

İlk görüntü oluşturmanız tamamlandığında şu düğmeler döndürülür:

Düğme	customId Deseni	Eylem	Sonuç
U1-U4	`MJ::JOB::upsample::1::xxx`	Tek bir görüntüyü upscale edin	Yüksek çözünürlüklü tek görüntü
V1-V4	`MJ::JOB::variation::1::xxx`	Varyasyonlar oluşturun	Yeni 4’lü ızgara
🔄	`MJ::JOB::reroll::0::xxx::SOLO`	Tümünü yeniden oluşturun	Yeni 4’lü ızgara

UPSCALE sonrası (tek görüntü)

Upscale işleminden sonra düzenleme araçlarına erişebilirsiniz:

Etiket	Modal Gerekli mi?
Upscale (Subtle) / Upscale (2x)	❌ Hayır
Upscale (Creative) / Upscale (4x)	❌ Hayır
Vary (Subtle) 🪄	❌ Hayır
Vary (Strong) 🪄	❌ Hayır
Vary (Region) 🖌️	✅ Evet (maske)
Zoom Out 2x / 1.5x 🔍	❌ Hayır
Custom Zoom 🔍	✅ Evet (prompt)
⬅️➡️⬆️⬇️ Pan	❌ Hayır
Animate 🎞️	❌ Hayır
🔄 Reroll	❌ Hayır

Not: Düğme etiketleri ve customId biçimleri, Prompt’unuzda belirtilen MJ sürümüne bağlı olarak değişebilir (ör. --v 6.1 ve --v 5.2). Düğmeleri her zaman API yanıtından okuyun.

Inpaint (Vary Region) düğmesi yalnızca Upscale işleminden sonra görünür.

Tam örnek: Oluşturma ve upscale

Adım 1: Imagine isteğini gönderin

curl -X POST 'https://api.cometapi.com/mj/submit/imagine' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "botType": "MID_JOURNEY",
    "prompt": "a cute cat --v 6.1",
    "accountFilter": { "modes": ["FAST"] }
  }'

Yanıt:

{ "code": 1, "result": "1768464763141701" }

Adım 2: Görev durumunu yoklayın

curl -X GET 'https://api.cometapi.com/mj/task/1768464763141701/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Yanıt (tamamlandığında):

{
  "status": "SUCCESS",
  "imageUrl": "https://api.cometapi.com/mj/image/1768464763141701",
  "buttons": [
    { "customId": "MJ::JOB::upsample::1::5f20922e-xxx", "label": "U1" },
    { "customId": "MJ::JOB::upsample::2::5f20922e-xxx", "label": "U2" },
    ...
  ]
}

Adım 3: Upscale için U1’e tıklayın

curl -X POST 'https://api.cometapi.com/mj/submit/action' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "taskId": "1768464763141701",
    "customId": "MJ::JOB::upsample::1::5f20922e-xxx"
  }'

Yanıt:

{ "code": 1, "result": "1768464800000000" }

Adım 4: Yeni görevi yoklayın ve sonucu alın

curl -X GET 'https://api.cometapi.com/mj/task/1768464800000000/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Şunu çağırdığınızda /mj/submit/action ve görev durumu MODAL yerine SUCCESS olursa, şunu çağırmanız gerekir /mj/submit/modal ek girdi sağlamak için.

İşlem	Düğme	Gönderilecekler
Inpaint	Vary (Region)	`maskBase64` (PNG maskesi) + `prompt`
Custom Zoom	🔍 Custom Zoom	`prompt` (örn. “your prompt —zoom 2”)

Örnek: Inpaint Akışı Inpaint eylemini başlatın:

curl -X POST 'https://api.cometapi.com/mj/submit/action' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"taskId": "<task_id>", "customId": "<custom_id>", "enableRemix": true}'

Yeni görevi bir kez sorgulayın. MODAL durumu, görevin maske ve Prompt gerektirdiği anlamına gelir:

curl -X GET 'https://api.cometapi.com/mj/task/<task_id>/fetch' \
  -H "Authorization: Bearer $COMETAPI_KEY"

Maske ve Prompt’u Modal API aracılığıyla gönderin:

curl -X POST 'https://api.cometapi.com/mj/submit/modal' \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "taskId": "<task_id>",
    "prompt": "replace with golden crown",
    "maskBase64": "data:image/png;base64,<base64-encoded-png-mask>"
  }'

Hız modu seçimi

Yola hız öneki ekleyin:

Mod	Yol Öneki	Örnek
Hızlı	`/mj-fast`	`/mj-fast/mj/submit/imagine`
Turbo	`/mj-turbo`	`/mj-turbo/mj/submit/imagine`
Relax	(varsayılan)	`/mj/submit/imagine`

Diğer giriş noktaları

Bu API’ler bağımsız giriş noktalarıdır ve imagine → action akışını izlemezler:

API	Amaç
`POST /mj/submit/blend`	2-5 görüntüyü tek bir görüntüde birleştirin
`POST /mj/submit/describe`	Görüntüden Prompt oluşturun
`POST /mj/submit/video`	Görüntüyü videoya dönüştürün
`POST /mj/submit/edits`	Görüntüyü maskeyle düzenleyin

Sorun giderme ipuçları

API tasarımına ve iş akışına göre karşılaşabileceğiniz yaygın sorunlar şunlardır:

Sorun	Olası Neden	Çözüm
Vary (Region) düğmesi bulunamıyor	4’lü ızgara görüntüsüne bakılıyor	Önce upscale yapın (U1-U4’e tıklayın), ardından düğmeleri kontrol edin
Görev durumu şurada takılı kaldı `MODAL`	İşlem ek girdi gerektiriyor	Şunu çağırın `/mj/submit/modal` gerekli verilerle
`customId` çalışmıyor	Eski veya sabit kodlanmış bir değer kullanılıyor	Güncel `customId` değerini her zaman şuradan alın `/mj/task/\{id\}/fetch` yanıtı
Boş `buttons` dizisi	Görev hâlâ devam ediyor	Düğmelere erişmeden önce `status: "SUCCESS"` durumunu bekleyin

İçerik moderasyonu

API anahtarları

Temel kavramı anlayın

4 temel API

Tam iş akışı diyagramı

Temel kavram: Düğmeler ve customId

Aşamaya göre düğme başvurusu

IMAGINE sonrası (4’lü ızgara görüntüsü)

UPSCALE sonrası (tek görüntü)

Tam örnek: Oluşturma ve upscale

Adım 1: Imagine isteğini gönderin

Adım 2: Görev durumunu yoklayın

Adım 3: Upscale için U1’e tıklayın

Adım 4: Yeni görevi yoklayın ve sonucu alın

Hız modu seçimi

Diğer giriş noktaları

Sorun giderme ipuçları

​Temel kavramı anlayın

​4 temel API

​Tam iş akışı diyagramı

​Temel kavram: Düğmeler ve customId

​Aşamaya göre düğme başvurusu

​IMAGINE sonrası (4’lü ızgara görüntüsü)

​UPSCALE sonrası (tek görüntü)

​Tam örnek: Oluşturma ve upscale

​Adım 1: Imagine isteğini gönderin

​Adım 2: Görev durumunu yoklayın

​Adım 3: Upscale için U1’e tıklayın

​Adım 4: Yeni görevi yoklayın ve sonucu alın

​Modal ne zaman gereklidir?

​Onaylanmış Modal işlemleri

​Hız modu seçimi

​Diğer giriş noktaları

​Sorun giderme ipuçları

Temel kavramı anlayın

4 temel API

Tam iş akışı diyagramı

Temel kavram: Düğmeler ve customId

Aşamaya göre düğme başvurusu

IMAGINE sonrası (4’lü ızgara görüntüsü)

UPSCALE sonrası (tek görüntü)

Tam örnek: Oluşturma ve upscale

Adım 1: Imagine isteğini gönderin

Adım 2: Görev durumunu yoklayın

Adım 3: Upscale için U1’e tıklayın

Adım 4: Yeni görevi yoklayın ve sonucu alın

Modal ne zaman gereklidir?

Onaylanmış Modal işlemleri

Hız modu seçimi

Diğer giriş noktaları

Sorun giderme ipuçları