Image Retrieval - Vectorize Image

서비스:

Cognitive Services - Computer Vision

API 버전:

2023-04-01-preview

이미지에서 벡터를 반환합니다.

POST /retrieval:vectorizeImage?api-version=2023-04-01-preview

선택적 매개 변수:

POST /retrieval:vectorizeImage?model-version={model-version}&api-version=2023-04-01-preview

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
api-version	query	True	string	요청된 API 버전입니다.
model-version	query		string	모델 버전.

요청 본문

Name	필수	형식	Description
url	True	string	이미지의 공개적으로 연결할 수 있는 URL입니다.

응답

Name	형식	Description
200 OK	SingleVectorResultApiModel	성공
Other Status Codes	ErrorResponse	오류 헤더 x-ms-error-code: string

예제

ImageRetrieval_VectorizeImage

샘플 요청

HTTP

POST /retrieval:vectorizeImage?model-version=2023-04-01-preview&api-version=2023-04-01-preview

{
  "url": "https://example.com/image.jpg"
}

샘플 응답

상태 코드:

200

{
  "vector": [
    0,
    1.1,
    2.2
  ],
  "modelVersion": "2023-04-01-preview"
}

정의

Name	Description
ErrorResponse	오류가 발생할 때 응답이 반환됩니다.
ErrorResponseDetails	오류 정보입니다.
ErrorResponseInnerError	자세한 오류입니다.
ImageUrl	분석할 이미지를 가리키는 URL이 있는 JSON 문서입니다.
SingleVectorResultApiModel	이미지 벡터화의 결과입니다.

ErrorResponse

오류가 발생할 때 응답이 반환됩니다.

Name	형식	Description
error	ErrorResponseDetails	오류 정보입니다.

ErrorResponseDetails

오류 정보입니다.

Name	형식	Description
code	string	오류 코드
details	ErrorResponseDetails[]	자세한 오류 목록입니다.
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.
target	string	오류의 대상입니다.

ErrorResponseInnerError

자세한 오류입니다.

Name	형식	Description
code	string	오류 코드
innererror	ErrorResponseInnerError	자세한 오류입니다.
message	string	오류 메시지입니다.

ImageUrl

분석할 이미지를 가리키는 URL이 있는 JSON 문서입니다.

Name	형식	Description
url	string	이미지의 공개적으로 연결할 수 있는 URL입니다.

SingleVectorResultApiModel

이미지 벡터화의 결과입니다.

Name	형식	Description
modelVersion	string	모델 버전.
vector	number[]	이미지의 벡터입니다.