mj_turbo_shorten

Specifiche tecniche di mj-turbo-shorten

Che cos’è mj-turbo-shorten?

mj-turbo-shorten è l’identificatore di piattaforma di CometAPI per una funzionalità di accorciamento dei prompt compatibile con Midjourney che combina il comportamento di /shorten di Midjourney con l’instradamento in modalità Turbo. L’elenco ufficiale dei comandi di Midjourney descrive /shorten come un modo per inviare un prompt lungo e ricevere suggerimenti per renderlo più conciso, e elenca separatamente /turbo come l’interruttore di modalità per l’operatività Turbo. Implementazioni proxy di Midjourney di terze parti espongono comunemente questa funzione tramite un endpoint dedicato di accorciamento nel percorso Turbo, tipicamente /mj-turbo/mj/submit/shorten.

In pratica, questo ID modello va inteso non come un LLM di testo generico, ma come un endpoint assistente orientato al compito per l’ottimizzazione dei prompt in ambito Midjourney. È pensato per sviluppatori o creatori che dispongono già di un prompt immagine dettagliato e vogliono che il sistema lo analizzi, identifichi le formulazioni comprimibili e restituisca una versione più concisa adatta a proseguire i flussi di lavoro con Midjourney.

Poiché le API in stile proxy Midjourney sono di solito asincrone, una richiesta di accorciamento viene in genere inviata per prima e poi verificata successivamente tramite un endpoint di fetch dell’attività. La documentazione dei provider compatibili con i proxy Midjourney mostra chiaramente questo schema: inviare l’attività di accorciamento, ricevere un ID attività, quindi effettuare il polling di /mj/task/{id}/fetch per recuperare lo stato e i risultati.

Funzionalità principali di mj-turbo-shorten

• Prompts condensati: aiuta a ridurre prompt Midjourney lunghi in versioni più concise, in linea con la funzione /shorten di Midjourney.
• Instradamento in modalità Turbo: utilizza la convenzione di percorso Turbo adottata dalle implementazioni proxy di Midjourney, in genere sotto /mj-turbo/mj, per gli utenti che desiderano il flusso di accorciamento associato alla modalità Turbo.
• Schema API compatibile con Midjourney: si adatta all’ecosistema proxy di Midjourney, dove gli endpoint sono organizzati per azioni come imagine, describe, shorten, action, modal e fetch.
• Flusso di lavoro asincrono: le richieste vengono in genere inviate come job anziché restituire immediatamente il risultato finale, rendendolo adatto a sistemi di workflow per immagini basati su coda.
• Input testuale semplice: l’operazione di accorciamento richiede principalmente un prompt, con implementazioni che comunemente accettano anche botType come MID_JOURNEY.
• Supporto al flusso di affinamento del prompt: utile prima della generazione dell’immagine quando si vuole semplificare la formulazione, rimuovere ridondanze o preparare un prompt più pulito per successive chiamate Midjourney. Questa è un’inferenza basata sul comportamento documentato di /shorten e sul design degli endpoint proxy.

Come accedere e integrare mj-turbo-shorten

Passaggio 1: registrati per ottenere una chiave API

Registrati su CometAPI e genera la tua chiave API dal dashboard. Successivamente, conservala in modo sicuro e usala nell’intestazione Authorization: Bearer YOUR_API_KEY per tutte le richieste all’API mj-turbo-shorten.

Passaggio 2: invia richieste all’API mj-turbo-shorten

Utilizza l’endpoint compatibile con Midjourney di CometAPI all’indirizzo POST /mj/submit/shorten.

curl https://api.cometapi.com/mj/submit/shorten \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "a futuristic cityscape at sunset --v 6.1",
    "botType": "MID_JOURNEY",
    "accountFilter": {
      "modes": ["TURBO"]
    }
  }'

Passaggio 3: recupera e verifica i risultati

L’API restituisce un oggetto attività con un ID attività. Effettua il polling di GET /mj/task/{task_id}/fetch per verificare lo stato della generazione e recuperare l’URL dell’immagine di output quando l’attività raggiunge uno stato terminale.