> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skiesoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 取得帳號資訊

> 取得當前帳號的使用量和配額資訊



## OpenAPI

````yaml api-reference/openapi.json get /account
openapi: 3.1.0
info:
  title: 軟雲聽有 AI API
  description: Skiesoft「聽有 AI」語音辨識服務 API，支援國台英混合語言辨識、即時串流處理和語音轉文字功能。提供高準確度的語音辨識、說話者分離等進階功能。
  version: 1.0.0
  contact:
    name: 軟雲技術支援
    email: support@skiesoft.com
    url: https://skiesoft.com
  license:
    name: Proprietary
    url: https://skiesoft.com/terms-of-service
  termsOfService: https://skiesoft.com/terms-of-service
servers:
  - url: https://api.skiesoft.com/v1
security:
  - bearerAuth: []
tags:
  - name: 語音辨識
    description: 音訊轉錄和語音辨識功能，支援說話者分離
  - name: 即時語音辨識
    description: WebSocket 即時語音串流辨識，支援低延遲的即時文字轉錄
  - name: 帳號管理
    description: 帳號資訊和使用量查詢
paths:
  /account:
    get:
      tags:
        - 帳號管理
      summary: 取得帳號資訊
      description: 取得當前帳號的使用量和配額資訊
      operationId: getAccountInfo
      responses:
        '200':
          description: 帳號資訊
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
              examples:
                account_info:
                  summary: 帳號資訊範例
                  value:
                    success: true
                    data:
                      usage:
                        currentMonth: 1250.5
                        quota: 10000
                        remaining: 8749.5
                        resetDate: '2024-02-01T00:00:00Z'
                      rateLimit:
                        requestsPerSecond: 50
                        concurrentConnections: 20
        '401':
          description: 身份驗證失敗
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AccountResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: 請求是否成功
          example: true
        data:
          type: object
          properties:
            usage:
              $ref: '#/components/schemas/UsageInfo'
            rateLimit:
              $ref: '#/components/schemas/RateLimitInfo'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - message
            - type
          properties:
            message:
              type: string
              description: 錯誤的人類可讀描述。
              example: 無效的 API 金鑰
            type:
              type: string
              description: 錯誤類型。
              example: invalid_request_error
            param:
              type: string
              description: 導致錯誤的參數（如果適用）。
              example: file
            code:
              type: string
              description: 錯誤代碼（如果適用）。
              example: invalid_api_key
    UsageInfo:
      type: object
      required:
        - currentMonth
        - quota
        - remaining
      properties:
        currentMonth:
          type: number
          description: 本月已使用分鐘數
          minimum: 0
          example: 1250.5
        quota:
          type: number
          description: 月配額分鐘數
          minimum: 0
          example: 10000
        remaining:
          type: number
          description: 剩餘配額分鐘數
          minimum: 0
          example: 8749.5
        resetDate:
          type: string
          format: date-time
          description: 配額重置日期
          example: '2024-02-01T00:00:00Z'
    RateLimitInfo:
      type: object
      properties:
        requestsPerSecond:
          type: integer
          description: 每秒請求數限制
          minimum: 1
          example: 50
        concurrentConnections:
          type: integer
          description: 並發連線數限制
          minimum: 1
          example: 20
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 使用 API 金鑰進行身份驗證。格式：Bearer YOUR_API_KEY

````