轉錄 API

Name: SRTGen
Rating: 4.9 (10000 reviews)

提交媒體進行 AI 轉錄和項目建立。支援影片和音訊檔案。

POST/api/v1/transcribe

快速實現

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "file=@/path/to/your/video.mp4"

POSThttps://api.srtgen.com/api/v1/transcribe

請求參數

參數	類型	是否必填	描述
`file`	File	Yes	待轉錄的媒體檔案 (Multipart)。支援格式：影片 (mp4, mov, avi, webm, mkv), 音訊 (mp3, wav, m4a, flac)。最大 2GB。
`videoUrl`	String	No*	媒體的外部 URL (如果請求體中未提供檔案，則此項必填)。
`name`	String	No	項目的自定義名稱。
`languageCode`	String	No	源語言代碼 (例如 'en-us')。如果省略，預設為 'auto' (自動檢測)。
`filterProfanity`	Boolean	No	是否自動審查敏感詞彙。預設為 false。
`disfluencies`	Boolean	No	是否包含語氣詞 (例如 '嗯', '啊')。預設為 false。
`medicalMode`	Boolean	No	針對醫療/醫藥音訊優化的轉錄。預設為 false。

高級：URL + AI 設定

curl -X POST https://api.srtgen.com/api/v1/transcribe \
  -H "x-api-key: <YOUR_API_KEY>" \
  -F "videoUrl=https://example.com/medical_lecture.mp4" \
  -F "languageCode=en-us" \
  -F "filterProfanity=true" \
  -F "disfluencies=false" \
  -F "medicalMode=true"

POSThttps://api.srtgen.com/api/v1/transcribe

成功響應

成功的請求返回 200 OK 狀態，包含項目和後台作業詳情。

projectId項目的唯一識別碼。
status'inProgress' (轉錄進行中)。
注意：額度將在轉錄流程完成後從您的餘額中異步計算並扣除。

{
  "success": true,
  "projectId": "proj_8k2n9m1b",
  "status": "inProgress"
}

錯誤代碼

狀態	錯誤代碼	描述
400	missing_file	在 'file' 或 'video' 欄位中未找到檔案。
400	unreachable_url	提供的 videoUrl 無法存取或返回錯誤。
400	invalid_parameter	其中一個參數 (例如 videoUrl) 格式錯誤。
400	file_read_failed	上傳的檔案無法讀取或已損壞。
401	unauthorized	API 金鑰缺失或無效。
403	insufficient_balance	您的額度不足以處理該時長的媒體。
403	storage_quota_exceeded	檔案超過了您計劃的剩餘雲端儲存配額。
413	payload_too_large	檔案超過了系統絕對 2GB 的上傳限制。
500	transcription_failed	無法啟動轉錄作業 (AI 提供商故障)。
500	server_error	出錯了，請稍後再試。

錯誤響應結構

{
  "success": false,
  "error": "insufficient_balance",
  "message": "您的項目需要 5 個額度，但您的餘額為 2。"
}

本頁面對您有幫助嗎？