開發者API
將Addavox本地化整合到您的工作流程中。選擇翻譯API以獲得獨立的翻譯音頻，或選擇視頻配音API以獲取包含時間軸、品質保證和字幕的完整視頻本地化。
API鍵
在Addavox應用程式中產生API密鑰。每個金鑰都使用與您的帳戶相同的套餐和包含的通話時間。
管理API鍵基本 URL:
https://api.addavox.com/api/v1
身份驗證標頭:
X-__ API __-鍵：您的鍵
服務概述
兩API ，滿足不同的本地化需求。
翻譯API
單一端點：POST /api/v1/localize — 從來源內容產生獨立的翻譯音訊。
Web 應用程式與此API的區別：當您在瀏覽器中使用Addavox產品時，片段編輯和本地化作業會在每個片段上保留預覽音頻，並將完整的混合節目延遲到您從項目頁面下載素材後才會生成。這些 v1 端點會在作業過程中建立拼接輸出，因此API客戶端無需單獨的匯出步驟即可取得結果。
工作原理
輸出格式
API會產生一個獨立的順序音訊檔案。每個翻譯片段都會依序產生並拼接在一起，片段之間有短暫的停頓。輸出文件與原始音訊在時間上沒有對齊——它是一個全新的音訊文件，旨在獨立播放。
為什麼要提供來源音訊和時間戳記？
來源音訊和分段時間戳記（start_time，end_time）用於識別和匹配原始錄音中每個說話者的聲音。這使得生成的音訊聽起來像原始說話者的聲音。這些時間戳記不控制輸出時序。
沒有品質保證或持續時間匹配
與視訊配音不同，翻譯API不進行文字重寫、語速調整或時間對齊。因此，它速度更快、價格更實惠。如果您需要音訊與原始視訊幀級同步，請使用視訊配音API 。
程式碼範例
視訊配音API表_0__
端點：POST /api/v1/localize-video — 完整的視訊在地化，包括時間軸、品質保證和字幕。
透過此API啟動的任務會在工作完成後產生每種語言的交付物。瀏覽器內Addavox應用程式使用相同的本地化引擎，但除非另有說明，否則會將完整的混合資源延遲到專案下載流程中。
您提供
- 視訊網址
- 原始語言
- 目標語言（一種或多種）
我們處理
- 音訊/視訊分離
- 轉錄
- 翻譯
- 法學碩士品質保證
- 語音合成
- 時序對齊
- 字幕生成
- 按語言進行視訊渲染
輸出格式
提供多種語言的視訊、音訊和字幕。另提供包含所有語言的壓縮包下載。簽名連結將在 24 小時後失效。
多語言工作
一個請求，多種語言。主作業會根據語言產生子作業。輪詢主作業以取得每種語言的狀態。狀態值：已排隊 → 運行中 → 已完成 | 失敗。
審閱者工作流程
透過API邀請人工審校人員。每位審校人員都會收到一封包含神奇連結的電子郵件，用於在網頁編輯器中編輯本地化內容——無需註冊帳戶。
程式碼範例
同意與授權
所有API請求都必須包含一個同意物件和一個頂級模式欄位。這些欄位共同構成一份針對每個作業的證明記錄，確認您擁有必要的權利和發言者同意。
模式欄位決定語音合成方式：「voice_matched」使用說話者語音克隆，「standard」使用合成文字轉語音（TTS）。兩種模式價格相同－選擇完全取決於使用者意願。
語音匹配模式－需獲得完全同意
標準模式－僅限內容權限
字段參考
| 場地 | 類型 | 必需的 | 描述 |
|---|---|---|---|
| mode | string | 頂級 | voice_matched 或者 standard |
| speaker_consent_obtained | boolean | 僅語音匹配 | 獲得可識別發言者的明確同意 |
| content_rights_confirmed | boolean | 兩種模式 | 內容的擁有權或有效許可 |
| eula_accepted | boolean | 兩種模式 | 接受Addavox最終使用者授權協議 |
| attested_by | string | 兩種模式 | 負責人的電子郵件地址或識別符 |
| attested_at | ISO 8601 | 兩種模式 | 請求發出後24小時內 |
同意錯誤代碼
| HTTP | 程式碼 | 狀態 |
|---|---|---|
| 403 | CONSENT_MISSING | 無同意對象 |
| 403 | CONSENT_INCOMPLETE | 缺少 attested_by 或 attested_at 無效 |
| 403 | CONSENT_NOT_AFFIRMED | 權利或最終用戶許可協議未得到確認。 |
| 403 | CONSENT_EXPIRED | attested_at 超過 24 小時 |
| 403 | SPEAKER_CONSENT_REQUIRED | 未經說話者同意的語音匹配 |
| 400 | INVALID_MODE | 無效的模式值 |
API參考
完整的互動式架構和其他端點可透過 Open API取得。
終點
| POST /localize | 預翻譯/部分轉錄音訊本地化 |
| POST /localize-video | 完整視訊配音（多語言） |
| GET /jobs/{job_id} | 職位狀態 |
| GET /jobs/{job_id}/result | 交付物（URL、壓縮包） |
| GET /jobs | 職位列表 |
| DELETE /jobs/{job_id} | 取消工作 |
| GET /account | 帳號資訊 |
| GET /voices | TTS語音目錄 |
| GET /languages | 支援的語言 |
| POST /projects/{id}/reviewers | 邀請審稿人 |
| GET|POST /jobs/{id}/webhooks | Webhook 狀態/重試 |
API服務定價
按訂閱套餐計費，每分鐘收費標準不同。以下價格為商務套餐年費（享八折優惠）。查看完整表格以了解所有套餐和服務詳情。
所示商業計劃價格已包含年度折扣。
自由的
視訊配音
包含（約分鐘）
2 min
基準利率（年利率）
/min
超重
$4.00/min
API服務
音訊分離
專有降噪語音軌道
基準利率
$0.03/min
超重
$0.04/min
包含（約分鐘）
~— min
性別檢測
根據語音和語境進行性別分類
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
轉錄（STT）
Deepgram語音轉文字功能（附語音分割）
基準利率
$0.05/min
超重
$0.06/min
包含（約分鐘）
~— min
翻譯
Google翻譯
基準利率
$0.03/min
超重
$0.04/min
包含（約分鐘）
~— min
文字轉語音
Google TTS 及其他服務提供者
基準利率
$0.06/min
超重
$0.08/min
包含（約分鐘）
~— min
語音匹配
專有語音克隆（全功能）
基準利率
$0.08/min
超重
$0.10/min
包含（約分鐘）
~— min
起動機
視訊配音
包含（約分鐘）
10 min
基準利率（年利率）
$2.80/min
超重
$3.60/min
API服務
音訊分離
專有降噪語音軌道
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
性別檢測
根據語音和語境進行性別分類
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
轉錄（STT）
Deepgram語音轉文字功能（附語音分割）
基準利率
$0.04/min
超重
$0.05/min
包含（約分鐘）
~— min
翻譯
Google翻譯
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
文字轉語音
Google TTS 及其他服務提供者
基準利率
$0.05/min
超重
$0.06/min
包含（約分鐘）
~— min
語音匹配
專有語音克隆（全功能）
基準利率
$0.08/min
超重
$0.10/min
包含（約分鐘）
~— min
創作者
視訊配音
包含（約分鐘）
30 min
基準利率（年利率）
$2.64/min
超重
$3.20/min
API服務
轉錄+翻譯+語音音頻
完整翻譯API包
基準利率
$0.11/min
超重
$0.13/min
包含（約分鐘）
~— min
翻譯 + 語音音訊
翻譯+語音音訊包
基準利率
$0.10/min
超重
$0.11/min
包含（約分鐘）
~— min
僅語音音訊
僅語音音訊包
基準利率
$0.08/min
超重
$0.10/min
包含（約分鐘）
~— min
音訊分離
專有降噪語音軌道
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
性別檢測
根據語音和語境進行性別分類
基準利率
$0.01/min
超重
$0.02/min
包含（約分鐘）
~— min
轉錄（STT）
Deepgram語音轉文字功能（附語音分割）
基準利率
$0.03/min
超重
$0.04/min
包含（約分鐘）
~— min
翻譯
Google翻譯
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
文字轉語音
Google TTS 及其他服務提供者
基準利率
$0.04/min
超重
$0.05/min
包含（約分鐘）
~— min
語音匹配
專有語音克隆（全功能）
基準利率
$0.06/min
超重
$0.08/min
包含（約分鐘）
~— min
專業版
視訊配音
包含（約分鐘）
120 min
基準利率（年利率）
$1.99/min
超重
$2.80/min
API服務
轉錄+翻譯+語音音頻
完整翻譯API包
基準利率
$0.10/min
超重
$0.11/min
包含（約分鐘）
~— min
翻譯 + 語音音訊
翻譯+語音音訊包
基準利率
$0.08/min
超重
$0.10/min
包含（約分鐘）
~— min
僅語音音訊
僅語音音訊包
基準利率
$0.06/min
超重
$0.08/min
包含（約分鐘）
~— min
音訊分離
專有降噪語音軌道
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
性別檢測
根據語音和語境進行性別分類
基準利率
$0.01/min
超重
$0.01/min
包含（約分鐘）
~— min
轉錄（STT）
Deepgram語音轉文字功能（附語音分割）
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
翻譯
Google翻譯
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
文字轉語音
Google TTS 及其他服務提供者
基準利率
$0.03/min
超重
$0.04/min
包含（約分鐘）
~— min
語音匹配
專有語音克隆（全功能）
基準利率
$0.05/min
超重
$0.06/min
包含（約分鐘）
~— min
商業
視訊配音
包含（約分鐘）
500 min
基準利率（年利率）
$1.60/min
超重
$2.40/min
API服務
轉錄+翻譯+語音音頻
完整翻譯API包
基準利率
$0.08/min
超重
$0.10/min
包含（約分鐘）
~— min
翻譯 + 語音音訊
翻譯+語音音訊包
基準利率
$0.06/min
超重
$0.08/min
包含（約分鐘）
~— min
僅語音音訊
僅語音音訊包
基準利率
$0.05/min
超重
$0.06/min
包含（約分鐘）
~— min
音訊分離
專有降噪語音軌道
基準利率
$0.01/min
超重
$0.02/min
包含（約分鐘）
~— min
性別檢測
根據語音和語境進行性別分類
基準利率
$0.01/min
超重
$0.01/min
包含（約分鐘）
~— min
轉錄（STT）
Deepgram語音轉文字功能（附語音分割）
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
翻譯
Google翻譯
基準利率
$0.02/min
超重
$0.02/min
包含（約分鐘）
~— min
文字轉語音
Google TTS 及其他服務提供者
基準利率
$0.02/min
超重
$0.03/min
包含（約分鐘）
~— min
語音匹配
專有語音克隆（全功能）
基準利率
$0.03/min
超重
$0.05/min
包含（約分鐘）
~— min
顯示的分鐘數是等效的—您的積分池在所有服務中共用。使用費用較低的服務，每分鐘消耗的積分也會減少。