> ## 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.

# API 參考

> 「聽有 AI」語音辨識 API 完整參考文件

## API 概述

「聽有 AI」提供強大且易於使用的 RESTful API，讓您能夠輕鬆整合語音辨識功能到您的應用程式中。我們的 API 支援即時語音辨識、批次處理、說話者分離等多種功能。

### 基本資訊

* **基礎 URL**: `https://api.skiesoft.com/v1`
* **協定**: HTTPS
* **認證方式**: API 金鑰 (Bearer Token)
* **資料格式**: JSON

## 快速開始

### 1. 取得 API 金鑰

1. 前往 [軟雲開發者控制台](https://skiesoft.com/console)
2. 建立新專案或選擇現有專案
3. 在專案設定中產生 API 金鑰

### 2. 認證設定

所有 API 請求都需要在 HTTP 標頭中包含有效的 API 金鑰：

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
```

### 3. 第一個 API 呼叫

```javascript theme={null}
const fs = require('fs');
const fetch = require('node-fetch');
const FormData = require('form-data');

const form = new FormData();
form.append('file', fs.createReadStream(audioPath));
form.append('model', 'thiannu-v1');

const response = await fetch('https://api.skiesoft.com/v1/audio/transcriptions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
  body: form
});
```

## 主要功能

### 語音轉文字

* 支援多種音訊格式（WAV、MP3、FLAC 等）
* 國台英混合語言辨識
* 高準確度轉錄

### 說話者分離

* 自動識別不同說話者
* 為每個說話者標記時間軸
* 支援多人會議記錄

### 即時語音辨識

* WebSocket 低延遲連線
* 即時串流處理
* 中間結果回傳

查看完整的 [SDK 文件](https://docs.skiesoft.com/sdks) 了解更多詳情。

## 速率限制

我們對 API 請求實施速率限制以確保服務品質：

| 方案   | 每秒請求數 | 每月配額       | 並發連線數 |
| ---- | ----- | ---------- | ----- |
| 免費試用 | 5     | 1,000 分鐘   | 2     |
| 基礎方案 | 20    | 10,000 分鐘  | 5     |
| 專業方案 | 50    | 100,000 分鐘 | 20    |
| 企業方案 | 100   | 無限制        | 50    |

## 測試環境

我們提供測試環境供開發和測試使用：

* **測試 URL**: `https://api-test.skiesoft.com/v1`
* **測試金鑰**: 以 `sk_test_` 開頭
* **限制**: 每日 1000 次請求，僅供測試使用

## 最佳實踐

### 音訊品質優化

* 使用 16kHz 採樣率獲得最佳效果
* 確保音訊為單聲道
* 移除背景噪音
* 保持適當的音量

### 效能優化

* 對於大檔案使用多部分上傳
* 實作請求重試機制
* 監控 API 使用量
* 使用適當的緩衝區大小

### 錯誤處理

* 實作優雅的錯誤處理
* 檢查 HTTP 狀態碼
* 解析錯誤回應訊息
* 提供使用者友善的錯誤提示

## 支援與資源

### 技術支援

* **電子郵件**: [support@skiesoft.com](mailto:support@skiesoft.com)
* **電話**: 04-3702-8737
* **線上文件**: [https://docs.skiesoft.com](https://docs.skiesoft.com)

### 開發者資源

* **API 狀態頁面**: [https://status.skiesoft.com](https://status.skiesoft.com)
* **開發者社群**: [https://community.skiesoft.com](https://community.skiesoft.com)
* **GitHub**: [https://github.com/Skiesoft](https://github.com/Skiesoft)

### 相關連結

* [快速開始指南](/quickstart)
* [認證說明](/essentials/authentication)
* [錯誤處理](/essentials/error-handling)
* [即時 API 指南](/essentials/real-time-api)

***

準備開始使用「聽有 AI」API？查看我們的[快速開始指南](/quickstart)或直接探索下方的 API 端點文件。