百度翻譯開放平台提供 HTTP API,支援自動語言偵測、多語言互譯。本文示範 ASP.NET (Web Forms / MVC) 後端串接流程:申請金鑰、建構請求、解析 JSON、批次翻譯與限流處理。
請求參數:`q` (待譯文本)、`from` (源語言)、`to` (目標語言)、`appid`、`salt` (隨機數)、`sign` (MD5簽名)。
sign = MD5(appid + q + salt + key) // 32 位小寫十六進位
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; } }
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;
}
}