安裝

使用.NET CLI 進行安裝

dotnet add package aliyun-net-sdk-alinlp

更多安裝與使用說明可參考：aliyun-openapi-net-sdk · GitHub

通過環境變量配置訪問憑證（AKSK）

1. 說明：

   1. 阿里云賬號AccessKey擁有所有API的訪問權限，風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維，請登錄RAM控制臺創建RAM用戶。

   2. 強烈建議不要把AccessKey和AccessKeySecret保存到代碼里，會存在密鑰泄漏風險，在此提供通過配置環境變量的方式來保存和訪問aksk

2. Linux和macOS系統配置方法

   export NLP_AK_ENV=<access_key_id>
   export NLP_SK_ENV=<access_key_secret>

   其中<access_key_id>替換為已準備好的AccessKey ID，<access_key_secret>替換為AccessKey Secret，AccessKey ID和AccessKey Secret的獲取方式見步驟二：獲取賬號的AccessKey

3. Windows系統配置方法

   1. 新建環境變量文件，添加環境變量NLP_AK_ENV和NLP_SK_ENV，并寫入已準備好的AccessKey ID和AccessKey Secret。

   2. 重啟Windows系統。

調用示例

以中文分詞算法為例，示例代碼如下所示

using System;
using System.Collections.Generic;
using Aliyun.Acs.Core;
using Aliyun.Acs.Core.Exceptions;
using Aliyun.Acs.Core.Profile;
using Aliyun.Acs.Core.Auth;
using Aliyun.Acs.alinlp.Model.V20200629;

namespace AlibabaCloud.SDK.Sample
{
    class Program
    {
        static void Main(string[] args)
        {
          /**
            * 阿里云賬號AccessKey擁有所有API的訪問權限，風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維，請登錄RAM控制臺創建RAM用戶。
            * 此處以把AccessKey和AccessKeySecret保存在環境變量為例說明。您也可以根據業務需要，保存到配置文件里。
            * 強烈建議不要把AccessKey和AccessKeySecret保存到代碼里，會存在密鑰泄漏風險
            */
            string accessKeyId = Environment.GetEnvironmentVariable("NLP_AK_ENV");
            string accessKeySecret = Environment.GetEnvironmentVariable("NLP_SK_ENV");
            AlibabaCloudCredentialsProvider provider = new AccessKeyCredentialProvider(accessKeyId, accessKeySecret);
            /* use STS Token
            AlibabaCloudCredentialsProvider provider = new StsCredentialProvider("<your-access-key-id>", "<your-access-key-secret>", "<your-sts-token>");
            */
            IClientProfile profile = DefaultProfile.GetProfile("cn-hangzhou");
            // 構建一個 Client，用于發起請求
            DefaultAcsClient client = new DefaultAcsClient(profile, provider);
            //構造請求
            var request = new GetWsChGeneralRequest();
            request.ServiceCode = "alinlp";
            request.TokenizerId = "GENERAL_CHN";
            request.Text = "智能體脂秤精準藍牙秤體重測人體脂肪秤家用稱健康電子秤";
            request.OutType = "1";
            try
            {
                //發起請求
                var response = client.GetAcsResponse(request);
                Console.WriteLine(System.Text.Encoding.Default.GetString(response.HttpResponse.Content));
            }
            catch (ServerException e)
            {
                Console.WriteLine(e);
            }
            catch (ClientException e)
            {
                Console.WriteLine(e);
            }
        }
    }
}

注：GetWsChGeneralRequest中的GetWsChGeneral是算法的actionName，可以替換成您需要的算法的值，并替換對應的參數，該值可在API參考文檔中的請求參數-Action-示例值中找到；

調用異常自助排查

若調用過程中出現異常可對照調用異常自助排查（錯誤碼匯總），找到表格中對應的描述，描述中包含具體錯誤原因和解決方案。