신청 절차
Midjourney Describe API를 사용하려면 먼저 신청 페이지 Midjourney Describe API에서 해당 서비스를 신청해야 합니다. 페이지에 들어가면 “Acquire” 버튼을 클릭합니다, 아래 그림과 같이:
로그인 또는 등록이 되어 있지 않으면 자동으로 로그인 페이지로 이동하여 등록 및 로그인을 요청합니다. 로그인 및 등록 후에는 자동으로 현재 페이지로 돌아옵니다.
첫 신청 시 무료 한도가 제공되어, 이 API를 무료로 사용할 수 있습니다.
요청 예시
우리는 한 장의 이미지를 예로 들어 이 API를 사용하는 방법을 시연합니다. 가정해보면, 우리는 한 장의 풍경 이미지를 가지고 있으며, 다음으로 이 이미지를 업로드하고 설명을 얻는 방법을 시연합니다.요청 예시 이미지
요청 헤더 및 요청 본문 설정
Request Headers에는 다음이 포함됩니다:accept: JSON 형식의 응답 결과를 수신하도록 지정하며, 여기에는application/json을 입력합니다.authorization: API 호출을 위한 키로, 신청 후 직접 드롭다운에서 선택할 수 있습니다.
image_url: 업로드할 이미지 파일 주소입니다.
코드 예시
페이지 오른쪽에는 다양한 언어의 코드가 자동으로 생성된 것을 확인할 수 있습니다, 아래 그림과 같이:
CURL
Python
응답 예시
요청이 성공하면, API는 이미지에 대한 4개의 설명 정보를 반환합니다. 예를 들어:descriptions 필드가 있으며, 그 안에는 네 개의 결과가 포함되어 있습니다. 각 결과는 후보 설명 내용입니다.
오류 처리
API를 호출할 때 오류가 발생하면, API는 해당 오류 코드와 정보를 반환합니다. 예를 들어:400 token_mismatched: 잘못된 요청, 누락되거나 잘못된 매개변수 때문일 수 있습니다.400 api_not_implemented: 잘못된 요청, 누락되거나 잘못된 매개변수 때문일 수 있습니다.401 invalid_token: 인증되지 않음, 잘못되었거나 누락된 인증 토큰입니다.429 too_many_requests: 너무 많은 요청, 비율 제한을 초과했습니다.500 api_error: 내부 서버 오류, 서버에서 문제가 발생했습니다.

