빠른 시작: 다중 모달 콘텐츠 분석(미리 보기)

다중 모달 API는 이미지 콘텐츠와 텍스트 콘텐츠가 모두 포함된 자료를 분석하여 사용자가 생성했거나 AI가 생성한 유해한 콘텐츠로부터 애플리케이션과 서비스를 더 안전하게 만듭니다. 이미지 및 관련 텍스트 콘텐츠를 함께 분석하면 컨텍스트를 유지하고 콘텐츠를 보다 포괄적으로 이해할 수 있습니다.

콘텐츠 필터링 방식에 대한 자세한 내용은 피해 범주 개념 페이지를 참조하세요. API 입력 제한에 대해서는 개요의 입력 요구 사항 섹션을 참조하세요.

필수 조건

• Azure 구독 - 체험 구독 만들기
• Azure 구독이 있으면 Azure Portal에서 콘텐츠 안전 리소스를 생성하여 키와 엔드포인트를 가져옵니다. 리소스의 고유한 이름을 입력하고, 구독을 선택하고, 리소스 그룹과 지원되는 지역, 지원되는 가격 책정 계층을 선택합니다. 다음으로 만들기를 선택합니다.
  • 리소스를 배포하는 데 몇 분 정도 걸립니다. 완료되면 리소스로 이동을 선택합니다. 왼쪽 창의 리소스 관리에서 구독 키 및 엔드포인트를 선택합니다. 나중에 사용할 수 있도록 엔드포인트와 키 값 중 하나를 임시 위치에 복사합니다.
• 다음 중 하나가 설치되었습니다.
  • REST API 호출을 위한 cURL.
  • Python 3.x가 설치되었습니다.

텍스트로 이미지 분석

다음 섹션에서는 cURL을 사용한 샘플 이미지 조정 요청을 살펴봅니다.

샘플 이미지 준비

분석할 샘플 이미지를 선택한 뒤 이를 디바이스에 다운로드합니다.

이미지 제한 사항은 입력 요구 사항을 참조하세요. 애니메이션이 적용된 형식에서는 서비스가 분석할 첫 번째 프레임을 추출합니다.

로컬 파일 스트림 또는 Blob Storage URL의 두 가지 방법 중 하나로 이미지를 입력할 수 있습니다.

• 로컬 파일 스트림(권장): 이미지를 base64로 인코딩합니다. codebeautify 등의 웹 사이트를 사용하여 인코딩을 수행할 수 있습니다. 그런 다음 인코딩된 문자열을 임시 위치에 저장합니다.
• Blob Storage URL: Azure Blob Storage 계정에 이미지를 업로드합니다. Blob Storage 빠른 시작에 따라 이 작업을 수행하는 방법을 알아봅니다. 그런 다음 Azure Storage Explorer 열어 이미지로 연결되는 URL을 가져옵니다. 임시 위치에 저장합니다.

텍스트로 이미지 분석

아래 명령을 텍스트 편집기에 붙여넣고 다음과 같이 변경합니다.

1. <endpoint>를 리소스 엔드포인트 URL로 바꿉니다.
2. <your_subscription_key>를 원하는 키로 바꿉니다.
3. 본문의 "image" 필드를 "content" 필드나 "blobUrl" 필드로 채웁니다. 예를 들어 {"image": {"content": "<base_64_string>"} 또는 {"image": {"blobUrl": "<your_storage_url>"}입니다.
4. 선택적으로 "text" 필드의 값을 분석하려는 자체 텍스트로 바꿉니다.

curl --location '<endpoint>/contentsafety/imageWithText:analyze?api-version=2024-09-15-preview ' \
--header 'Ocp-Apim-Subscription-Key: <your_subscription_key>' \
--header 'Content-Type: application/json' \
--data '{
  "image": {
      "content": "<base_64_string>"
 },
  "categories": ["Hate","Sexual","Violence","SelfHarm"],
  "enableOcr": true,
  "text": "I want to kill you"
}'

{
  "image": {
    "blobUrl": "<your_storage_url>"
  }
}

아래 필드가 URL에 포함되어야 합니다.

요청 본문의 매개 변수는 다음 표에 정의되어 있습니다.

명령 프롬프트 창을 열고 cURL 명령을 실행합니다.

출력

콘솔에 이미지 및 텍스트 조정 결과가 JSON 데이터로 표시됩니다. 예시:

{
  "categoriesAnalysis": [
    {
      "category": "Hate",
      "severity": 2
    },
    {
      "category": "SelfHarm",
      "severity": 0
    },
    {
      "category": "Sexual",
      "severity": 0
    },
    {
      "category": "Violence",
      "severity": 0
    }
  ]
}

출력의 JSON 필드는 다음과 같이 정의됩니다.