本章以「文字翻譯」端點為例，帶您完成第一個請求。後續章節會深入認證、錯誤處理、字庫與串流。

三步驟開始

1. 登入控制台並完成帳號設定。
2. 在「API 金鑰」頁面建立一把新金鑰。金鑰僅顯示一次，請立即複製並妥善保存。
3. 在 HTTP Header 帶入 X-API-Key，向翻譯端點送出 POST 請求。

範例：翻譯一段文字

向 POST /api/v1/translations/text 送出文字、目標語言與來源語言（可省略，由系統自動偵測）。

curl -X POST "https://abemono.abestar.com.tw/api/v1/translations/text" \
  -H "X-API-Key: [YOUR_API_KEY]" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, how are you?",
    "target_language": "zh-TW",
    "source_language": "en-US"
  }'

成功回應

回傳 200，data 內含翻譯結果與本次使用的模型代碼；usage 顯示計費字數。

{
  "translated_text": "你好，你好嗎？",
  "detected_source_lang": "en-US",
  "usage": {
    "quota_percent": {
      "used": 5
    }
  },
  "forced_replacement_count": 0
}

錯誤回應

失敗時統一回傳 error 物件：code 為錯誤代碼字串、message 為人類可讀說明、request_id 是本次請求的識別碼，回報問題時請一併附上。

{
  "error": {
    "code": "unauthorized",
    "message": "API key is missing or invalid.",
    "details": {},
    "request_id": "0af7651916cd43dd8448eb211c80319c"
  }
}