빠른 시작: Computer Vision REST API 및 cURL을 사용하여 원격 이미지 분석Quickstart: Analyze a remote image using the Computer Vision REST API and cURL

이 빠른 시작에서는 원격으로 저장된 이미지를 분석하여 Computer Vision REST API를 사용하여 시각적 기능을 추출합니다.In this quickstart, you'll analyze a remotely stored image to extract visual features using the Computer Vision REST API. 이미지 분석 메서드를 사용하면 이미지 콘텐츠를 기반으로 하여 시각적 특징을 추출할 수 있습니다.With the Analyze Image method, you can extract visual features based on image content.

필수 구성 요소Prerequisites

  • Azure 구독 - 체험 구독 만들기An Azure subscription - Create one for free
  • cURLcURL
  • Azure 구독을 보유한 후에는 Azure Portal에서 Computer Vision 리소스 를 만들어 키와 엔드포인트를 가져옵니다.Once you have your Azure subscription, create a Computer Vision resource in the Azure portal to get your key and endpoint. 배포 후 리소스로 이동을 클릭합니다.After it deploys, click Go to resource.
    • 애플리케이션을 Computer Vision 서비스에 연결하려면 만든 리소스의 키와 엔드포인트가 필요합니다.You will need the key and endpoint from the resource you create to connect your application to the Computer Vision service. 이 빠른 시작의 뒷부분에 나오는 코드에 키와 엔드포인트를 붙여넣습니다.You'll paste your key and endpoint into the code below later in the quickstart.
    • 평가판 가격 책정 계층(F0)을 통해 서비스를 사용해보고, 나중에 프로덕션용 유료 계층으로 업그레이드할 수 있습니다.You can use the free pricing tier (F0) to try the service, and upgrade later to a paid tier for production.

샘플 명령 만들기 및 실행Create and run the sample command

샘플을 만들고 실행하려면 다음 단계를 수행합니다.To create and run the sample, do the following steps:

  1. 다음 명령을 텍스트 편집기에 복사합니다.Copy the following command into a text editor.
  2. 필요한 경우 명령에서 다음 내용을 변경합니다.Make the following changes in the command where needed:
    1. <subscriptionKey>의 값을 구독 키로 바꿉니다.Replace the value of <subscriptionKey> with your subscription key.
    2. 요청 URL(westcentralus)의 첫 번째 부분을 고유한 엔드포인트 URL의 텍스트로 바꿉니다.Replace the first part of the request URL (westcentralus) with the text in your own endpoint URL.

      참고

      2019년 7월 1일 이후에 만들어진 새 리소스는 사용자 지정 하위 도메인 이름을 사용합니다.New resources created after July 1, 2019, will use custom subdomain names. 자세한 내용 및 지역별 엔드포인트의 전체 목록은 Cognitive Services에 대한 사용자 지정 하위 도메인 이름을 참조하세요.For more information and a complete list of regional endpoints, see Custom subdomain names for Cognitive Services.

    3. 필요한 경우 요청 본문의 이미지 URL(http://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg\)을 분석할 다른 이미지의 URL로 변경합니다.Optionally, change the image URL in the request body (http://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg\) to the URL of a different image to be analyzed.
  3. 명령 프롬프트 창을 엽니다.Open a command prompt window.
  4. 텍스트 편집기에서 명령 프롬프트 창으로 명령을 붙여넣은 후 명령을 실행합니다.Paste the command from the text editor into the command prompt window, and then run the command.
curl -H "Ocp-Apim-Subscription-Key: <subscriptionKey>" -H "Content-Type: application/json" "https://westcentralus.api.cognitive.microsoft.com/vision/v3.1/analyze?visualFeatures=Categories,Description&details=Landmarks" -d "{\"url\":\"http://upload.wikimedia.org/wikipedia/commons/3/3c/Shaki_waterfall.jpg\"}"

응답 검사Examine the response

성공적인 응답이 JSON을 통해 반환됩니다.A successful response is returned in JSON. 애플리케이션 예제는 다음 예제와 유사하게 명령 프롬프트 창에서 성공한 응답을 구문 분석하고 표시합니다.The sample application parses and displays a successful response in the command prompt window, similar to the following example:

{
  "categories": [
    {
      "name": "outdoor_water",
      "score": 0.9921875,
      "detail": {
        "landmarks": []
      }
    }
  ],
  "description": {
    "tags": [
      "nature",
      "water",
      "waterfall",
      "outdoor",
      "rock",
      "mountain",
      "rocky",
      "grass",
      "hill",
      "covered",
      "hillside",
      "standing",
      "side",
      "group",
      "walking",
      "white",
      "man",
      "large",
      "snow",
      "grazing",
      "forest",
      "slope",
      "herd",
      "river",
      "giraffe",
      "field"
    ],
    "captions": [
      {
        "text": "a large waterfall over a rocky cliff",
        "confidence": 0.916458423253597
      }
    ]
  },
  "requestId": "b6e33879-abb2-43a0-a96e-02cb5ae0b795",
  "metadata": {
    "height": 959,
    "width": 1280,
    "format": "Jpeg"
  }
}

다음 단계Next steps

이미지를 분석하고, 유명인 및 랜드마크를 검색하고, 썸네일을 만들고, 인쇄 및 필기 텍스트를 추출하는 데 사용되는 Computer Vision API를 살펴봅니다.Explore the Computer Vision API used to analyze an image, detect celebrities and landmarks, create a thumbnail, and extract printed and handwritten text. Computer Vision API를 사용하여 신속하게 실험하려면 API 테스트 콘솔 열기를 사용하세요.To rapidly experiment with the Computer Vision API, try the Open API testing console.