API 參考 - Abestar API

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

公開查詢

Public

共 4 個端點

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

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

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": "zh-TW", "name": "Traditional Chinese" },
    { "code": "en-US", "name": "English (US)" },
    { "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-V1-251215",
      "name": "PSSC V1",
      "description": "第一代翻譯模型"
    },
    {
      "code": "PSSC-V2-251215",
      "name": "PSSC V2",
      "description": "第二代翻譯模型"
    },
    {
      "code": "PSSC-V3-251215",
      "name": "PSSC V3",
      "description": "第三代翻譯模型"
    }
  ]
}

Error Codes

internal_server_error

Notes

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

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

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": "zh-TW", "name": "Traditional Chinese" },
    { "code": "en-US", "name": "English (US)" },
    { "code": "ja-JP", "name": "Japanese" }
  ]
}

Error Codes

internal_server_error

Notes

ASR 端點 /api/v1/audio/transcriptions 的 detected_language 會以此清單中的 code 回傳。

回傳語音辨識模組目前可用的所有模型代碼、顯示名稱與說明；無需認證。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-std-v1",
      "name": "Tranc Standard V1",
      "description": "標準語音辨識模型"
    },
    {
      "code": "tranc-pro-v1",
      "name": "Tranc Pro V1",
      "description": "進階語音辨識模型"
    }
  ]
}

Error Codes

internal_server_error

Notes

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