API 參考 - Abestar API

探索 Abestar API 的所有端點，了解如何整合各種強大的服務。

公開查詢

Public

共 4 個端點

翻譯與 ASR 模組支援的語言與模型清單；無需認證。

回傳翻譯模組目前支援的所有語言代碼與顯示名稱；無需任何認證標頭。code 為 BCP 47 形式（例 zh-TW、en-US），可直接作為 /api/v1/translations/text 的 source_language / target_language 欄位值。目前共支援 27 種語言（含 yue-Hant-HK 粵語（香港））。

Authorization

公開端點（無需認證）

Request Examples

bash

curl https://abemono.abestar.com.tw/translations/languages

Responses

支援語言完整清單。

Name	Type	Description
languagesRequired	object[]	語言條目陣列；每元素 `{ code: string, name: string }`。code 為 BCP 47 語言代碼，name 為英文顯示名稱。

json

{
  "languages": [
    { "code": "en-US", "name": "English (US)" },
    { "code": "zh-TW", "name": "Traditional Chinese (Taiwan)" },
    { "code": "zh-CN", "name": "Simplified Chinese (China)" },
    { "code": "yue-Hant-HK", "name": "Cantonese (Hong Kong)" },
    { "code": "ja-JP", "name": "Japanese" }
  ]
}

Error Codes

internal_server_error

Notes

翻譯與 ASR 模組各自維護獨立的語言清單；若同時使用兩端，請分別呼叫 /translations/languages 與 /audio/languages 取得實際支援清單。

回傳翻譯模組目前可用的所有模型代碼、顯示名稱與說明；無需認證。code 可直接作為 /api/v1/translations/text 的 model 欄位值。

Authorization

公開端點（無需認證）

Request Examples

bash

curl https://abemono.abestar.com.tw/translations/models

Responses

可用模型完整清單。

Name	Type	Description
modelsRequired	object[]	模型條目陣列；每元素 `{ code: string, name: string, description: string }`。code 為呼叫翻譯端點時要傳的識別字串。

json

{
  "models": [
    {
      "code": "PSSC-V2-251215",
      "name": "PSSC V2",
      "description": "第二代翻譯模型，改善翻譯品質"
    },
    {
      "code": "PSSC-V3-251215",
      "name": "PSSC V3",
      "description": "第三代翻譯模型，最佳翻譯品質"
    }
  ]
}

Error Codes

internal_server_error

Notes

本端點回傳目前可在翻譯端點使用的所有模型清單。目前共 2 個模型代碼（如上列示）；`description` 欄位以繁中撰寫。

回傳語音辨識模組目前支援的所有語言代碼與顯示名稱；無需任何認證標頭。code 為 BCP 47 形式（例 zh-TW、en-US），用於 /api/v1/audio/transcriptions 的 language 欄位值。目前共支援 27 種語言（含 yue-Hant-HK 粵語（香港））。

Authorization

公開端點（無需認證）

Request Examples

bash

curl https://abemono.abestar.com.tw/audio/languages

Responses

支援語言完整清單。

Name	Type	Description
languagesRequired	object[]	語言條目陣列；每元素 `{ code: string, name: string }`。code 為 BCP 47 語言代碼，name 為英文顯示名稱。

json

{
  "languages": [
    { "code": "en-US", "name": "English (US)" },
    { "code": "zh-TW", "name": "Traditional Chinese (Taiwan)" },
    { "code": "zh-CN", "name": "Simplified Chinese (China)" },
    { "code": "yue-Hant-HK", "name": "Cantonese (Hong Kong)" },
    { "code": "ja-JP", "name": "Japanese" }
  ]
}

Error Codes

internal_server_error

Notes

ASR 端點 /api/v1/audio/transcriptions 的 detected_language 會以此清單中的 code 回傳；無法判斷語言時則回 `"und"`（BCP-47 undetermined，不在此清單、也不可作為請求的 language 參數值）。

回傳語音辨識模組目前可用的所有模型代碼、顯示名稱與說明；無需認證。code 可直接作為 /api/v1/audio/transcriptions 的 model 欄位值。

Authorization

公開端點（無需認證）

Request Examples

bash

curl https://abemono.abestar.com.tw/audio/models

Responses

可用模型完整清單。

Name	Type	Description
modelsRequired	object[]	模型條目陣列；每元素 `{ code: string, name: string, description: string }`。code 為呼叫 ASR 端點時要傳的識別字串。

json

{
  "models": [
    {
      "code": "tranc-adv-v1",
      "name": "Advanced V1",
      "description": "進階辨識，適合品質需求較高的情境"
    },
    {
      "code": "tranc-pro-v1",
      "name": "Professional V1",
      "description": "高精度辨識，適合專業領域"
    }
  ]
}

Error Codes

internal_server_error

Notes

ASR 與翻譯模型清單完全獨立，不應假設兩端可使用相同 code。目前共 2 個模型代碼（如上列示）；`description` 欄位以繁中撰寫。