平台簡介
OmniDoc API 面向一個帳號下的檔案與內容工作流程。呼叫方使用 API Key 創建資源,隨後用返回的穩定 ID 查詢、組合、處理或下載。
| 資源 | 用途 |
|---|---|
| 文件 / 文件 | 帳戶擁有的原始檔案與檔案庫條目 |
| 作業 / 程序 | 翻譯、文件處理或音視訊非同步任務 |
| 工件 | 任務交付的可預覽或可下載結果 |
| 信用操作 | 一次收費動作的實扣與退款憑證 |
資源始終按帳號歸屬進行驗證。用戶端只需保存公開 ID,不應從 ID、檔名或下載位址推斷實現細節。
通用呼叫流程
Section titled “通用呼叫流程”- 建立或選擇輸入資源。
- 確認帳戶有可用積分:開始前按門檻檢查餘額,完成後按實際用量扣費。
- 使用
Idempotency-Key創建任務。 - 查詢任務狀態;檔案翻譯任務還可使用 SSE 或 Webhook。
- 讀取結果和本次積分憑證。
外部集成統一使用 API Key,權限與創建 Key 的帳號一致。詳情見 認證 。
快速入門 → 上傳檔案、建立任務、查詢狀態並下載結果