API 參考

​

API 概述

​

基本資訊

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

​

快速開始

​

1. 取得 API 金鑰

1. 前往 軟雲開發者控制台
2. 建立新專案或選擇現有專案
3. 在專案設定中產生 API 金鑰

​

2. 認證設定

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

​

3. 第一個 API 呼叫

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 低延遲連線
• 即時串流處理
• 中間結果回傳

​

速率限制

​

測試環境

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

​

最佳實踐

​

音訊品質優化

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

​

效能優化

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

​

錯誤處理

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

​

支援與資源

​

技術支援

• 電子郵件: support@skiesoft.com
• 電話: 04-3702-8737
• 線上文件: https://docs.skiesoft.com

​

開發者資源

• API 狀態頁面: https://status.skiesoft.com
• 開發者社群: https://community.skiesoft.com
• GitHub: https://github.com/Skiesoft

​

相關連結

• 快速開始指南
• 認證說明
• 錯誤處理
• 即時 API 指南