Hoppa till huvudinnehåll
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

curl -X POST 'https://api.acedata.cloud/midjourney/describe' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/kg7xp3.png"
}'

​
Python

import requests

url = "https://api.acedata.cloud/midjourney/describe"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/kg7xp3.png"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

​
Svarsexempel

När begäran lyckas kommer API:t att returnera 4 beskrivningar av bilden. Till exempel: 
{
  "descriptions": [
    "Ett korsformat vägskylt står i mitten av en utomhuspark, omgiven av träd och gräsmarker. Bakgrunden är solig med varma färger. Solen skiner genom bladen på en del av den. På ena sidan av den vägposten fanns också en annan skylt med texten \"Kunming Park\", som såg mycket vacker ut. Denna bild visar hur underbar naturen kan vara. Den ger människor känslor av avkoppling eller lugn i naturens stil. --ar 75:44",
    "Ett foto av en \"K鬥\" vägskylt i parken, med träd och gräs på båda sidor. Framför finns en ljusgul metallstång med två skyltar fästa vid den. Bakgrunden har solens strålar som skiner genom gröna blad på ena sidan av gatan, vilket skapar en varm atmosfär. Det finns också vattenånga som svävar runt. Det togs i stil med Sony A7R IV-kamera med Leica M-objektiv. Denna scen förmedlar lugn och harmoni mellan natur och mänsklig skapelse. --ar 75:44",
    "Ett korsformat vägskylt står i mitten av en öppen park, omgiven av träd och gräsmark. Solen skiner genom bladen på en del av den, vilket skapar en varm ljuseffekt. Framför finns en väg som leder till ett annat grönt område. Det finns också information om \"Inuti Shilin Park\" på ena sidan av den posten. Denna scen ger människor känslor av lugn och harmoni med naturen. Naturligt ljus, 3D-rendering i stil med Unreal Engine, realistisk fotografistil. --ar 75:44",
    "Ett korsformat skylt står i parken, omgiven av frodiga träd och livligt grönt gräs under solljus. Skyltar säger \"VIDEO ANNattacks\" på ett okänt språk, vilket skapar en atmosfär av mysterium och nyfikenhet. Scenen fångas med högupplöst fotografering med Canon EOS R5-kameror, vilket presenterar en fantastisk visuell effekt som visar intrikata detaljer i stil med modern fotografering. --ar 75:44"
  ]
}
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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
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.