萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 串接百度翻譯 API 實作英文轉中文 (含批次、限流處理)

前言

百度翻譯開放平台提供 HTTP API,支援自動語言偵測、多語言互譯。本文示範 ASP.NET (Web Forms / MVC) 後端串接流程:申請金鑰、建構請求、解析 JSON、批次翻譯與限流處理。

1. 申請 API 金鑰

  1. 登入 百度翻譯開放平台。
  2. 建立應用,獲取 **APP ID** 與 **密鑰 (Key)**。
  3. 免費版:每月 100 萬字元,QPS 限制 (通常 10-50)。

2. API 簽名算法 (MD5)

請求參數:`q` (待譯文本)、`from` (源語言)、`to` (目標語言)、`appid`、`salt` (隨機數)、`sign` (MD5簽名)。

sign = MD5(appid + q + salt + key) // 32 位小寫十六進位

3. 完整 C# 封裝類別

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Security.Cryptography;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

public class BaiduTranslateClient
{
    private readonly string _appId;
    private readonly string _key;
    private readonly HttpClient _http;
    private readonly Random _rnd = new Random();

    public BaiduTranslateClient(string appId, string key, HttpClient http = null)
    {
        _appId = appId;
        _key = key;
        _http = http ?? new HttpClient();
    }

    public async Task TranslateAsync(string text, string from = "auto", string to = "zh")
    {
        if (string.IsNullOrWhiteSpace(text)) return string.Empty;
        
        var salt = _rnd.Next(100000, 999999).ToString();
        var sign = ComputeSign(text, salt);
        
        var url = $"https://fanyi-api.baidu.com/api/trans/vip/translate" +
                  $"?q={Uri.EscapeDataString(text)}&from={from}&to={to}&appid={_appId}&salt={salt}&sign={sign}";
        
        var resp = await _http.GetStringAsync(url);
        var result = JsonSerializer.Deserialize(resp);
        
        if (result?.ErrorCode != null && result.ErrorCode != "52000") // 52000 成功
            throw new Exception($"百度翻譯錯誤: {result.ErrorCode} - {result.ErrorMsg}");
        
        return string.Join("\n", result.TransResult.Select(r => r.Dst));
    }

    public async Task> TranslateBatchAsync(IEnumerable texts, string from = "auto", string to = "zh", int delayMs = 1000)
    {
        var results = new List();
        foreach (var text in texts)
        {
            try 
            {
                results.Add(await TranslateAsync(text, from, to));
            }
            catch (Exception ex)
            {
                results.Add($"[ERROR] {ex.Message}");
            }
            await Task.Delay(delayMs); // 限流:免費版建議 >= 1000ms
        }
        return results;
    }

    private string ComputeSign(string q, string salt)
    {
        var raw = _appId + q + salt + _key;
        using (var md5 = MD5.Create())
        {
            var hash = md5.ComputeHash(Encoding.UTF8.GetBytes(raw));
            return BitConverter.ToString(hash).Replace("-", "").ToLower();
        }
    }
}

public class BaiduResponse
{
    public string ErrorCode { get; set; }
    public string ErrorMsg { get; set; }
    public List TransResult { get; set; }
}
public class TransItem { public string Src { get; set; } public string Dst { get; set; } }

4. ASP.NET Web Forms 使用範例

protected async void btnTranslate_Click(object sender, EventArgs e)
{
    var client = new BaiduTranslateClient("你的APP_ID", "你的KEY");
    try
    {
        string result = await client.TranslateAsync(txtInput.Text, "en", "zh");
        lblResult.Text = result;
    }
    catch (Exception ex)
    {
        lblResult.Text = "翻譯失敗: " + ex.Message;
    }
}

5. 重要限制與最佳實務

  • 單次請求長度限制:`q` 參數最大 **6000 位元組** (約 2000 中文字)。長文需自行分段。
  • QPS 限制:免費版通常 10-50 QPS,必須在批次迴圈加 `Task.Delay`。
  • 編碼:`Uri.EscapeDataString` 必須用於 `q` 參數,包含換行、特殊符號。
  • 錯誤碼處理:52001 (逾時)、52002 (服務錯誤)、52003 (未授權)、54000 (必要參數缺失)、54001 (簽名錯誤)、54003 (存取頻率過高)、54004 (帳戶餘額不足)。
  • HTTPS:正式環境務必使用 `https://fanyi-api.baidu.com`。

替代方案

  • Google Cloud Translation API:付費、品質高、支援 Glossary、AutoML。
  • Azure Translator Text:企業級、文件翻譯、自訂術語。
  • 開源離線模型:Argos Translate (Python/.NET bindings)、M2M-100 (需 GPU)。
copyright © 萬盛學電腦網 all rights reserved