全部產品
Search
文件中心

Content Moderation:圖片OCR識別

更新時間:Dec 30, 2025

本文介紹了如何使用.NET SDK圖片OCR介面,識別圖片中的文字資訊。

功能描述

通用OCR除了能夠識別普通圖片中的文字,還能識別結構化卡證上的文字。關於參數的詳細說明,請參見圖片OCR檢測API文檔

說明
  • 本 SDK 僅支援傳入圖片 URL,不支援本地檔案或位元據。

  • 支援的 URL 類型:公網 HTTP/HTTPS,長度不超過 2048 個字元。

前提條件

已安裝.NET依賴。關於安裝.NET依賴的具體操作,請參見安裝.NET依賴

說明

請一定按照安裝.NET依賴頁面中的版本安裝,否則會導致調用失敗。

提交圖片同步檢測任務

介面

描述

支援的Region

ImageSyncScanRequest

提交圖片OCR同步識別任務,對圖片中的文字進行識別(scene=ocr)。

  • cn-shanghai

  • cn-beijing

  • cn-shenzhen

  • ap-southeast-1

範例程式碼

using System;
using Newtonsoft.Json;
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Http;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Green.Model.V20180509;
using System.Collections.Generic;

namespace csharp_sdk_sample
{
    class Program
    {
        static void Main(string[] args)
        {
            /**
             * 常見擷取環境變數方式:
             *     擷取RAM使用者AccessKey ID:Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID");
             *     擷取RAM使用者AccessKey Secret:Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
             */
            DefaultProfile profile = DefaultProfile.GetProfile(
                    "cn-shanghai",
                    "建議從環境變數中擷取RAM使用者AccessKey ID",
                    "建議從環境變數中擷取RAM使用者AccessKey Secret");
            DefaultAcsClient client = new DefaultAcsClient(profile);

            ImageSyncScanRequest request = new ImageSyncScanRequest();
            request.AcceptFormat = FormatType.JSON;
            request.ContentType = FormatType.JSON;
            request.Method = MethodType.POST;
            request.Encoding = "UTF-8";

            Dictionary<string, object> task1 = new Dictionary<string, object>();
            task1.Add("dataId", "檢測資料ID");
            //task1.Add("url", "待檢測圖片連結地址");
            task1.Add("url", "http://example.com/xx.jpg");

            // 樣本:身份證正面識別。
            Dictionary<string, object> cardExtras = new Dictionary<string, object>();
            cardExtras.Add("card", "id-card-front");

            Dictionary<string, object> httpBody = new Dictionary<string, object>();
            // scenes:檢測情境。
            httpBody.Add("scenes", new List<string> { "ocr" });
            httpBody.Add("bizType", "業務情境");
            httpBody.Add("extras", cardExtras);
            httpBody.Add("tasks", new List<Dictionary<string, object>> { task1 });

            request.SetContent(System.Text.Encoding.Default.GetBytes(JsonConvert.SerializeObject(httpBody)), "utf-8", FormatType.JSON);
            try
            {
                ImageSyncScanResponse response = client.GetAcsResponse(request);
                if (response.HttpResponse.Status != 200)
                {
                    Console.WriteLine("the request failed. status:{0}", response.HttpResponse.Status);
                }
                Console.WriteLine(System.Text.Encoding.Default.GetString(response.HttpResponse.Content));
            }
            catch (Exception ex)
            {
                Console.WriteLine("Failed with error info: {0}", ex.Message);
            }
        }
    }
}