빠른 시작: API 사용

  • 아티클

Important

Azure Media Services 사용 중지 발표로 인해 Azure AI Video Indexer는 Azure AI Video Indexer 기능 조정을 발표합니다. AZURE AI Video Indexer 계정에 대한 의미를 이해하려면 AMS(Azure Media Service) 사용 중지와 관련된 변경 내용을 참조하세요. AMS 사용 중지 준비: VI 업데이트 및 마이그레이션 가이드를 참조하세요.

Azure AI Video Indexer는 Microsoft에서 제공하는 다양한 오디오 및 비디오 AI(인공 지능) 기술을 하나의 통합 서비스로 통합하여 더 쉽게 개발할 수 있도록 합니다. Azure AI Video Indexer는 개발자가 클라우드 플랫폼의 규모, 글로벌 도달률, 가용성 및 안정성에 대해 걱정하지 않고 미디어 AI 기술을 사용하는 데 집중할 수 있도록 설계되었습니다. API를 사용하여 파일을 업로드하고, 자세한 비디오 인사이트를 얻고, 포함 가능한 인사이트 URL, 플레이어 위젯 등을 가져올 수 있습니다.

Azure AI Video Indexer 웹 사이트를 처음 방문하면 평가판 계정이 자동으로 만들어집니다. 평가판 계정을 사용하면 무료 인덱싱 시간을 가져올 수 있습니다. 나중에 유료 계정을 추가할 수 있습니다. 유료 옵션을 사용하면 인덱싱된 시간에 대해 요금을 지불합니다. 사용 가능한 계정(평가판 및 유료 옵션)에 대한 자세한 내용은 Azure AI Video Indexer 계정 유형을 참조하세요.

이 문서에서는 Azure AI Video Indexer API를 사용하는 방법을 보여줍니다.

필수 조건

미디어 파일을 업로드합니다. 다음과 같은 두 가지 방법이 있습니다.

  1. 선택한 URL에 미디어 파일을 업로드합니다(권장). 공용 네트워크 위치를 사용할 수 있습니다. 파일을 업로드한 후 파일을 복사하여 브라우저의 위치 표시줄에 붙여넣어 AVI에 액세스할 수 있는지 여부를 검사 수 있습니다. 미디어 파일을 재생할 수 있는 경우 VI도 액세스할 수 있습니다. Azure Storage Blob을 사용하여 스토리지 위치를 보호하려면 파일을 업로드하고 SAS URL을 가져옵니다. 파일에 대한 보안 URL을 가져오는 방법에 대한 자세한 내용은 Azure Blob Storage SAS URL을 참조 하세요. 이 URL은 인덱싱을 위해 Azure AI Video Indexer에 파일을 복사하는 데 사용됩니다.

  2. 요청 본문에 비디오 파일을 바이트 배열로 보냅니다. 요청 본문에서 미디어 파일을 바이트 배열로 업로드하는 방법에 대한 자세한 내용은 .NET을 사용하여 Blob 업로드를 참조하세요.

참고 항목

API 요청 제한은 초당 10개 요청 및 분당 최대 120개 요청입니다.

API 구독

Important

  • Azure AI Video Indexer에 등록할 때 사용한 것과 동일한 전자 메일을 사용해야 합니다.
  • 개인 Google 및 Microsoft(Outlook/Live) 계정은 평가판 계정에만 사용할 수 있습니다. Azure에 연결된 계정에는 Entra ID가 필요합니다.
  • 이메일당 하나의 활성 계정만 있을 수 있습니다. 사용자가 LinkedIn에서 user@gmail.com을 사용하여 로그인하고 나중에 Google에서 user@gmail.com을 사용하여 로그인하려고 하면 사용자가 이미 존재한다는 오류 페이지가 표시됩니다.
  • 키를 보호해야 합니다. 서버 코드에서만 사용할 수 있습니다. 클라이언트 쪽(.js, .html 등)에서 사용할 수 없습니다.
  1. Azure AI Video Indexer API 개발자 포털에 로그인합니다.
  2. 제품 탭을 선택하여 구독합니다. 그런 다음 권한 부여를 선택하고 구독합니다. 새 사용자는 자동으로 권한 부여에 가입됩니다.
  3. 기본 키와 보조 키를 찾아 복사하고 저장합니다. 프로필에서 구독을 찾을 수 있습니다. 기본 및 보조 키는 구독 섹션에 있습니다 .
  4. 기본 키와 보조 키 모두에 대한 표시 링크를 선택합니다. 환경 변수 파일에서 사용할 준비가 될 때까지 복사하여 텍스트 편집기로 붙여넣습니다.

권한 부여 API를 사용하여 액세스 토큰 가져오기

애플리케이션의 모든 사용자에게 모든 액세스 권한을 부여하고 싶지는 않습니다. VI에 대한 액세스 수준은 여러 가지가 있습니다.

수준 비디오 보기 비디오 처리 프로젝트 보기 프로젝트 처리 계정 보기 계정 관리
비디오 읽기 권한자 ✔️
비디오 참가자 ✔️ ✔️
프로젝트 판독기 ✔️ ✔️
프로젝트 기여자 ✔️ ✔️ ✔️ ✔️
계정 읽기 권한자 ✔️ ✔️ ✔️
계정 기여자 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

액세스 토큰 요청 만들기 및 보내기

요청에서 subscription-id, resource-group-nameVI account-name 를 설정하고 요청 본문의 scope 및 permissionType 매개 변수를 필요한 액세스 수준으로 설정합니다.

예를 들어 사용자가 프로젝트에서 작업할 수 있지만 계정으로 작업할 수 없도록 사용자에게 액세스 권한을 제공하려는 경우 "기여자"와 scope "프로젝트"로 설정합니다permissionType. 프로젝트에 projectId대한 사용 권한을 설정하는 경우 .


POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.VideoIndexer/accounts/{account-name}/generateAccessToken?api-version=2024-01-01

{
  "permissionType": "Reader",
  "scope": "Project",
  "projectId": "07ec9e38d4"
}

샘플 응답

{
  "accessToken": "<jwt token of 1260 characters length>"
}

범위 및 사용 권한 유형을 설정하는 자세한 예제는 VI REST API를 참조하세요.

API 사용 시작

API 사용을 시작할 준비가 완료되었습니다. 각 Azure AI Video Indexer REST API에 대한 자세한 설명을 찾아보세요.

환경 변수 파일에서 키를 사용하고 액세스 토큰을 사용하는 자세한 예제는 Azure AI Video Indexer 샘플을 참조하세요.

권장 사항