Skip to main content
Midjourney Describe API:s huvudfunktion är att få en beskrivning av en bild genom att ladda upp den. För att använda API:t behöver du bara ange bildfilens adress, så kommer API:t att returnera en detaljerad beskrivning av bilden. Ingen komplicerad parameterinställning krävs för att få högkvalitativa bildbeskrivningar. Stöder flera bildformat: oavsett om det är JPEG, PNG eller GIF, kan alla vanliga bildformat enkelt kännas igen och hanteras. Detta dokument kommer att ge en detaljerad beskrivning av hur man integrerar Midjourney Describe API, vilket hjälper dig att enkelt integrera och fullt utnyttja API:ts kraftfulla funktioner. Genom Midjourney Describe API kan du enkelt automatisera bildbeskrivningar och öka affärseffektiviteten.

Ansökningsprocess

För att använda Midjourney Describe API måste du först gå till ansökningssidan Midjourney Describe API för att ansöka om den aktuella tjänsten. När du kommer till sidan, klicka på knappen “Acquire”, som visas i bilden nedan: Ansökningssidan Om du inte har loggat in eller registrerat dig kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in. Efter att du har loggat in eller registrerat dig kommer du automatiskt att återvända till den aktuella sidan. Vid första ansökan kommer det att finnas en gratis kvot som gör att du kan använda API:t kostnadsfritt.

Begärningsexempel

Vi tar en bild som exempel för att visa hur man använder API:t. Anta att vi har en landskapsbild, och vi visar hur man laddar upp den bilden och får en beskrivning.

Begärningsexempelbild

Exempelbild

Ställ in begärningshuvuden och begärningskropp

Begärningshuvuden inkluderar:
  • accept: anger att du tar emot svar i JSON-format, här anges som application/json.
  • authorization: nyckeln för att anropa API:t, som kan väljas direkt efter ansökan.
Begärningskropp inkluderar:
  • image_url: adressen till den uppladdade bildfilen.
Inställningarna ser ut som på bilden nedan:

Kodexempel

Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas i bilden nedan:

Några kodexempel är som följer:

CURL

Python

Svarsexempel

När begäran lyckas kommer API:t att returnera 4 beskrivningar av bilden. Till exempel:
Det kan ses att resultatet innehåller ett descriptions-fält, som innehåller fyra resultat, där varje resultat är en kandidatbeskrivning.

Felhantering

När du anropar API:t, om du stöter på ett fel, kommer API:t att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

Felrespons exempel

Slutsats

Genom detta dokument har du fått en förståelse för hur man använder Midjourney Describe API för bildbeskrivningar. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:t. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.