Skip to main content
Główną funkcją Midjourney Describe API jest uzyskiwanie opisu obrazów poprzez przesyłanie zdjęć. Korzystając z tego API, wystarczy przekazać adres pliku obrazu, a API zwróci szczegółowy opis obrazu. Nie ma potrzeby skomplikowanego ustawiania parametrów, aby uzyskać wysokiej jakości opisy obrazów. Obsługuje wiele formatów obrazów: niezależnie od tego, czy jest to JPEG, PNG, czy GIF, wszystkie popularne formaty obrazów są łatwo rozpoznawane i przetwarzane. Dokument ten szczegółowo opisuje integrację z Midjourney Describe API, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Dzięki Midjourney Describe API możesz łatwo zautomatyzować opisywanie obrazów, zwiększając efektywność biznesową.

Proces aplikacji

Aby korzystać z Midjourney Describe API, należy najpierw przejść do strony aplikacji Midjourney Describe API, aby ubiegać się o odpowiednią usługę. Po wejściu na stronę kliknij przycisk „Acquire”, jak pokazano na obrazku: Strona aplikacji Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować. Po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

Przykład żądania

Weźmy jako przykład jedno zdjęcie, aby pokazać, jak korzystać z tego API. Załóżmy, że mamy zdjęcie krajobrazu, a następnie pokażemy, jak przesłać to zdjęcie i uzyskać opis.

Przykład żądania

Przykładowe zdjęcie

Ustawienia nagłówków żądania i ciała żądania

Nagłówki żądania obejmują:
  • accept: określa, że oczekiwany jest wynik w formacie JSON, tutaj wpisz application/json.
  • authorization: klucz do wywołania API, po aplikacji można go bezpośrednio wybrać z rozwijanej listy.
Ciało żądania obejmuje:
  • image_url: adres pliku obrazu do przesłania.
Ustawienia są pokazane na poniższym obrazku:

Przykład kodu

Można zauważyć, że po prawej stronie strony automatycznie wygenerowano kod w różnych językach, jak pokazano na obrazku:

Niektóre przykłady kodu są następujące:

CURL

Python

Przykład odpowiedzi

Po pomyślnym złożeniu żądania API zwróci 4 opisy obrazu. Na przykład:
Można zauważyć, że w wyniku znajduje się pole descriptions, które zawiera cztery wyniki, z których każdy jest kandydatem na opis.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit szybkości.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z Midjourney Describe API do opisywania obrazów. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W przypadku jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.