Skip to main content
La principale funzionalità dell’API Midjourney Describe è quella di ottenere una descrizione di un’immagine caricata. Utilizzando questa API, è sufficiente fornire l’indirizzo del file immagine e l’API restituirà una descrizione dettagliata dell’immagine. Non è necessaria una complessa configurazione dei parametri per ottenere descrizioni di alta qualità. Supporta vari formati di immagine: sia che si tratti di JPEG, PNG o GIF, tutti i formati di immagine più comuni possono essere facilmente riconosciuti e gestiti. Questo documento fornirà una guida dettagliata sull’integrazione dell’API Midjourney Describe, aiutandoti a integrare facilmente e sfruttare appieno le potenti funzionalità di questa API. Con l’API Midjourney Describe, puoi automatizzare la descrizione delle immagini e migliorare l’efficienza aziendale.

Processo di richiesta

Per utilizzare l’API Midjourney Describe, è necessario prima andare alla pagina di richiesta Midjourney Describe API per richiedere il servizio corrispondente. Una volta entrati nella pagina, cliccare sul pulsante “Acquire”, come mostrato nell’immagine: Pagina di richiesta Se non sei ancora loggato o registrato, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere. Dopo aver effettuato la registrazione e il login, verrai automaticamente riportato alla pagina corrente. Alla prima richiesta, verrà fornito un credito gratuito, che ti consente di utilizzare l’API senza costi.

Esempio di richiesta

Prendiamo come esempio un’immagine per dimostrare come utilizzare questa API. Supponiamo di avere un’immagine di paesaggio, e ora mostreremo come caricare l’immagine e ottenere una descrizione.

Esempio di immagine di richiesta

Immagine di esempio

Impostazione dell’intestazione della richiesta e del corpo della richiesta

Request Headers includono:
  • accept: specifica di ricevere la risposta in formato JSON, qui si compila con application/json.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Request Body include:
  • image_url: l’indirizzo del file immagine caricato.
Impostare come mostrato nell’immagine seguente:

Esempio di codice

Si può notare che sul lato destro della pagina sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell’immagine:

Alcuni esempi di codice sono i seguenti:

CURL

Python

Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà 4 descrizioni dell’immagine. Ad esempio:
Si può notare che nel risultato c’è un campo descriptions, che contiene quattro risultati, ognuno dei quali è un contenuto descrittivo candidato.

Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

Esempio di risposta di errore

Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API Midjourney Describe per la descrizione delle immagini. Speriamo che questo documento ti aiuti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.