VAS API DocsVAS API Docs
REST API

我的方案 API

GET /api/v1/me/plan

功能說明

查詢這把 API Key 目前的計費制度與方案內容（v1.9.0 新增）。

被方案限制擋下時（plan_feature_not_allowed、plan_daily_limit_reached、too_many_languages 等，見 錯誤碼參考 – 方案限制錯誤），可用此端點查「我的方案含什麼、離上限多遠、限制何時恢復」。

  • 唯讀端點：不改變任何狀態。
  • 零餘額也可查詢：點數用盡時仍可查詢。
  • 回應反映這把 key 實際擁有的權益；方案內容事後被調整不影響已開通的授權。

相關端點：金鑰自助查詢 API（點數批次、用量紀錄、API Key 設定）。

使用場景

  • 收到 HTTP 403（plan_feature_not_allowed）或 402（plan_daily_limit_reached）後，查方案內容與恢復時間
  • 在 UI 上呈現方案功能組合、今日已用量與各項上限
  • 判斷目前計費制度（點數制／吃到飽方案）

認證方式

Header：X-API-Key（詳見 認證機制）

請求參數

此端點不需要任何請求參數。

請求範例

curl -X GET "https://vas-poc.vurbo.ai/api/v1/me/plan" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

成功回應

HTTP 200。回應形狀依這把 key 的計費制度分為三種：

形狀 1：吃到飽方案（綁定方案）

{
  "data": {
    "mode": "unlimited",
    "plan": {
      "name": "專業方案",
      "expired_at": "2027-07-31T23:59:59+08:00"
    },
    "features": [
      { "slug": "stt", "name": "基礎語音轉錄", "included": true },
      { "slug": "bilingual", "name": "互譯模式（雙語）", "included": true },
      { "slug": "ai_interpret", "name": "AI 語音口譯（TTS）", "included": false },
      { "slug": "diarization", "name": "語者分離", "included": true },
      { "slug": "sentence_translate", "name": "整句翻譯", "included": true },
      { "slug": "realtime_translate", "name": "即時翻譯", "included": false },
      { "slug": "vocab", "name": "專業詞語庫", "included": true },
      { "slug": "broadcast", "name": "廣播", "included": false }
    ],
    "oneoff_features": [
      { "slug": "summary", "name": "AI 會議摘要", "included": true },
      { "slug": "retranslate", "name": "全文重翻", "included": true },
      { "slug": "import", "name": "檔案匯入", "included": false }
    ],
    "limits": {
      "daily_soft_limit_minutes": 480,
      "daily_hard_limit_minutes": 600,
      "max_concurrent_sessions": 2,
      "daily_used_minutes": 123,
      "max_transcription_languages": 4,
      "max_session_minutes": 240,
      "rolling_limit_minutes": 3000,
      "rolling_used_minutes": 850,
      "auth_total_limit_minutes": 60000,
      "auth_total_used_minutes": 12345,
      "restriction_recovery_at": null
    }
  }
}

形狀 2：點數制

{
  "data": {
    "mode": "credit",
    "plan": null,
    "available_credit": 480.5
  }
}

形狀 3：無方案限制的吃到飽授權（罕見）

{
  "data": {
    "mode": "unlimited",
    "plan": null,
    "features": { "all": true },
    "expired_at": "2027-01-31T23:59:59+08:00"
  }
}

回應欄位說明

共通欄位

欄位類型說明
data.modestring計費制度：credit（點數制）／unlimited（吃到飽）
data.planobject | null方案基本資訊；點數制與「無方案限制的吃到飽授權」為 null

形狀 1（吃到飽方案）

欄位類型說明
data.plan.namestring | null方案名稱（僅供顯示；權益以 features／oneoff_features／limits 為準）
data.plan.expired_atstring | null方案到期時間（ISO 8601）
data.featuresarray每分鐘計費類功能清單，每項含 slug／name／included。included: true 表示方案包含該功能；廣播（broadcast）恆為 false（廣播一律不含在吃到飽方案內，照點數計費）
data.oneoff_featuresarray一次性功能清單（如 AI 會議摘要 summary、全文重翻 retranslate、檔案匯入 import），欄位同上
data.limitsobject方案各項上限與目前用量（見下表）

data.limits 欄位（值為 null 表示該項不限，或目前無法計算）

欄位類型說明
daily_soft_limit_minutesinteger | null每日用量門檻（分鐘）。達門檻後當場錄音會被定期中斷（daily_limit_disconnect），可立即開始新的錄音（同一條連線上重新開始時，上一場處理完成後才會收到 session_started）
daily_hard_limit_minutesinteger | null每日用量硬上限（分鐘）。達上限後當日不可再開始錄音／匯入（daily_limit_reached／REST plan_daily_limit_reached），隔日重置
max_concurrent_sessionsinteger | null併發錄音上限（同一把 API Key 同時進行的錄音數）
daily_used_minutesinteger | null今日已用分鐘數（錄音＋匯入合計，依帳號時區的當日）
max_transcription_languagesinteger | null同時識別語言數上限。超過時 start 回 too_many_languages（details.max 帶此值）
max_session_minutesinteger | null單次錄音上限（分鐘）
rolling_limit_minutesinteger | null滾動累計用量上限（分鐘）
rolling_used_minutesinteger | null目前滾動累計已用分鐘數
auth_total_limit_minutesinteger | null授權期間總用量上限（分鐘）
auth_total_used_minutesinteger授權期間累計已用分鐘數
restriction_recovery_atstring | null目前在限制窗口中時，預計恢復時間（ISO 8601）；不在限制窗口為 null

即時錄音的上述上限在每一分鐘開始前判斷，達到時下一分鐘不會開始、也不計入用量；同一把 API Key 同時進行多場錄音時，達到定期中斷的門檻後，每一場都會在各自的下一分鐘開始前中斷。錄音的每一分鐘在開始時即計入 daily_used_minutes、rolling_used_minutes 與 auth_total_used_minutes。

形狀 2（點數制）

欄位類型說明
data.available_creditfloat目前可用點數（與 POST /api/v1/imports/check-quota 的 remain_quota 同型別、同語意）

形狀 3（無方案限制的吃到飽授權）

欄位類型說明
data.featuresobject固定為 { "all": true }（無功能限制）
data.expired_atstring | null授權到期時間（ISO 8601）

吃到飽授權一律綁定在單一 API Key 上，且開通時就會帶方案內容。此形狀只在授權沒有方案內容時出現，實務上罕見；整合時仍建議一併處理，避免遇到時解析失敗。

特有錯誤碼

此端點無特有錯誤碼，僅可能回傳通用認證錯誤（如 401 auth_missing_api_key／auth_invalid_api_key）。

版本：V1.24.1 最後更新：2026-09-29

金鑰自助查詢 API

用這把 API Key 查詢它自己的點數批次、用量紀錄與設定（V1.21.0 新增）。

說話者 API

Copyright © 2026