Generazione immagini Midjourney v8.2 / Niji 7

Usa l'API asincrona per immagini su https://apimaster.ai/v1 con midjourney-v8.2 o midjourney-niji-7. L'ID del modello seleziona la versione; non aggiungere campi di override della versione.

Crea un task

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

Per Niji 7, imposta model su midjourney-niji-7:

{"model":"midjourney-niji-7","prompt":"anime character under cherry blossoms","size":"9:16","speed":"fast"}

Campo	Tipo	Obbligatorio	Descrizione
model	stringa	Sì	midjourney-v8.2 o midjourney-niji-7
prompt	stringa	Sì	Descrizione dell'immagine, inclusi i parametri Midjourney supportati
size	stringa	No	Proporzioni come 1:1 o 16:9; il valore predefinito è 1:1
speed	stringa	No	relax, fast o turbo; il valore predefinito è relax
image_urls	stringa[]	No	Da 1 a 20 URL di immagini di riferimento; sono accettati anche Data URL di immagini supportati
iw	numero	No	Peso dell'immagine di riferimento 0–3; richiede image_urls
quality	stringa	No	0.25, 0.5, 1 o 2; non supportato da Niji 7
stylize / chaos / weird	intero	No	Intervalli: 0–1000, 0–100 e 0–3000, rispettivamente
seed	intero	No	Seme casuale 0–4294967295
negative_prompt	stringa	No	Contenuto da escludere
sref / sw	stringa / intero	No	URL pubblico di riferimento di stile e peso 0–1000; sw richiede sref
dref / dw	stringa o stringa[] / numero	No	URL di riferimento (fino a 20) e peso 0–100; dw richiede dref
raw / tile / hd	booleano	No	Stile raw, tiling e HD; tile e hd sono solo per v8.2
extra	stringa	No	Stringa di parametri supportati come --ar 16:9 --s 750; i campi strutturati hanno la precedenza
metadata	oggetto	No	Metadati aziendali personalizzati
repeat	intero	No	2–40 per creare più task

Niji 7 non supporta quality, tile=true o hd=true. Entrambi i modelli rifiutano draft=true, cref, cw, stop e i campi della richiesta version e niji. style=raw viene normalizzato in raw=true. Non usare --v o --niji in prompt o extra per sovrascrivere la versione del modello.

La risposta contiene un ID batch e gli ID dei task:

{
  "id": "imagine_batch_xxxxxxxx",
  "request_id": "req_xxxxxxxx",
  "model": "midjourney-v8.2",
  "status": "queued",
  "data": [{"id": "imagine_xxxxxxxx", "task_id": "imagine_xxxxxxxx", "status": "submitted"}]
}

Controlla lo stato del task

curl -s "https://apimaster.ai/v1/tasks/imagine_batch_xxxxxxxx" \
  -H "Authorization: Bearer YOUR_API_KEY"

La risposta completata include gli URL delle immagini in data; tasks contiene ogni task figlio:

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

Esegui il polling mentre lo stato è queued o processing. In caso di errore, leggi tasks[].error e non inviare di nuovo la stessa richiesta. Scarica tempestivamente gli URL restituiti perché potrebbero scadere.

Se l'invio restituisce 502 con un header X-Task-ID, o una query restituisce pending_timeout, salva l'ID e continua a controllarne lo stato invece di inviare automaticamente di nuovo. Un batch può contenere sia task riusciti che non riusciti; ispeziona tasks[] singolarmente. Si consiglia di eseguire il polling una volta ogni 15 secondi.

Errori e prezzi

model e un prompt non vuoto sono obbligatori. Versioni non supportate, proporzioni non valide, riferimenti inaccessibili e parametri non supportati restituiscono 400. 401 indica una chiave non valida, 402 indica saldo insufficiente e 429 indica limitazione di velocità. Consulta la scheda Midjourney v8.2 e la scheda Niji 7 per i prezzi e le route attuali.