기본 요건: 배포된 색인이 포함된 일괄 동영상 창고를 만듭니다.
콘솔에서 일괄 동영상 창고 데이터 검색
콘솔
Vertex AI Vision 대시보드의 창고 탭을 엽니다.
검색하려는 색인 엔드포인트를 찾아 애셋 검색을 클릭합니다.
동영상 목록 (각각 저작물에 해당)과 상단에 검색창 1개가 표시됩니다. 동영상을 클릭하여 보거나 동영상 검색을 시작할 수 있습니다.
검색을 시작하려면 텍스트 검색어를 입력하거나 이미지를 검색어로 업로드합니다. 검색 결과 페이지의 오른쪽에 동영상 클립 목록이 표시되며, 각 클립은 저작물의 연속 동영상 클립에 해당합니다. 동영상 클립은 입력 검색어와의 관련성을 기준으로 순위가 매겨집니다.
검색 결과 페이지 왼쪽에 있는
Filters
섹션을 사용하여 검색을 세부적으로 조정할 수 있습니다. 각 필터 기준은 데이터 스키마 키와 검색하려는 주석 값으로 구성됩니다. 필터 기준을 지정한 후 검색을 클릭하여 검색을 실행합니다.
명령줄을 사용하여 일괄 동영상 창고 데이터 검색
자료 (corpus
)에서 동영상 (assets
)을 검색하려면 찾고자 하는 콘텐츠로 searchIndexEndpoint
요청 본문을 채웁니다.
이러한 콘텐츠는 다음과 같은 다양한 형식으로 제공됩니다.
text_query
또는image_query
: 검색할 검색어입니다.- 선택사항
criteria
: 사용자가 제공한 주석의 필터 기준입니다.
다음 예에서는 자연 경관 동영상이 포함된 자료 집합을 고려해 보겠습니다.
'해변의 일몰'과 관련이 있고 주석 "state": "California"
로 태그된 모든 저작물을 검색하려면 다음 요청을 전송합니다.
REST 및 명령줄
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- REGIONALIZED_ENDPOINT: 엔드포인트에
LOCATION_ID
와 일치하는 접두사(예:europe-west4-
)가 포함될 수 있습니다. 지역화된 엔드포인트에 대해 자세히 알아보세요. - PROJECT_NUMBER: 프로젝트 번호입니다. Google Cloud
- LOCATION_ID: Vertex AI Vision을 사용하는 리전입니다. 예를 들면 다음과 같습니다.
us-central1
,europe-west4
사용 가능한 리전을 참고하세요. - INDEX_ENDPOINT_ID: 타겟 색인 엔드포인트의 ID입니다.
HTTP 메서드 및 URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint
JSON 요청 본문:
{ "text_query": "sunset at beach", "criteria": [ { "field": "state", "text_array": { "txt_values": [ "California" ] } } ] }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "searchResultItems": [ { "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1" }, { "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2" } ] }
해변에서 일몰을 촬영한 이미지가 있다면 다음 요청을 전송하여 이미지를 검색어로 사용할 수도 있습니다 (입력 이미지는 base64 인코딩 형식).
REST 및 명령줄
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- REGIONALIZED_ENDPOINT: 엔드포인트에
LOCATION_ID
와 일치하는 접두사(예:europe-west4-
)가 포함될 수 있습니다. 지역화된 엔드포인트에 대해 자세히 알아보세요. - PROJECT_NUMBER: 프로젝트 번호입니다. Google Cloud
- LOCATION_ID: Vertex AI Vision을 사용하는 리전입니다. 예를 들면 다음과 같습니다.
us-central1
,europe-west4
사용 가능한 리전을 참고하세요. - INDEX_ENDPOINT_ID: 타겟 색인 엔드포인트의 ID입니다.
HTTP 메서드 및 URL:
POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint
JSON 요청 본문:
{ "image_query": { "input_image": "IMAGE_BYTES" }, "criteria": [ { "field": "state", "text_array": { "txt_values": [ "California" ] } } ] }
요청을 보내려면 다음 옵션 중 하나를 선택합니다.
curl
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint"
PowerShell
요청 본문을 request.json
파일에 저장하고 다음 명령어를 실행합니다.
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/indexEndpoints/INDEX_ENDPOINT_ID:searchIndexEndpoint" | Select-Object -Expand Content
다음과 비슷한 JSON 응답이 표시됩니다.
{ "searchResultItems": [ { "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_1" }, { "asset": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/assets/ASSET_ID_2" } ] }