SoulDub
關閉菜單

文件

SoulDub 影片翻譯 Agent API 參考

面向 Agent、後端服務和自動化腳本的 SoulDub 影片翻譯 API 執行時參考。

SoulDub 影片翻譯 Agent API 參考

面向 Agent、後端服務和自動化腳本的 SoulDub 影片翻譯 API 執行時參考。

Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。

1. 影片翻譯 Agent API 參考

查看上傳、任務、輪詢、結果下載和錯誤碼。

  • Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。
  • 限制說明
  • 積分不換算為保證的影片分鐘數，建立任務前請以產品顯示的預估消耗為準。

2. 適用範圍

POST /video-uploads/initiate
POST /video-uploads/presign-part
PUT {presignedUrl}
POST /video-uploads/complete
POST /video-translations
GET /video-translations/{taskId}
GET /video-translations/{taskId}/results
GET /video-translations/{taskId}/results/files/{variant}
GET /video-translations/{taskId}/results/subtitles/{variant}

Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。

3. 內容責任主體

查看上傳、任務、輪詢、結果下載和錯誤碼。

Authorization: Bearer ${AGENT_API_KEY}
X-API-Key: ${AGENT_API_KEY}
Content-Type: application/json
Accept: application/json
  • 限制說明
  • 積分不換算為保證的影片分鐘數，建立任務前請以產品顯示的預估消耗為準。
  • 一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。

4. 影片翻譯 Agent API 參考

Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。

  • POST /video-uploads/initiate
  • POST /video-uploads/presign-part
  • PUT {presignedUrl}
  • POST /video-uploads/complete
filename: demo.mp4
contentType: video/mp4
fileSizeBytes: 342556

5. 影片翻譯 Agent API 參考

查看上傳、任務、輪詢、結果下載和錯誤碼。

POST /video-translations
Idempotency-Key: ${UNIQUE_IDEMPOTENCY_KEY}
  • Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。
  • 積分不換算為保證的影片分鐘數，建立任務前請以產品顯示的預估消耗為準。
  • 一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。

6. 更新日期

Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。

GET /video-translations/{taskId}
  • pending
  • processing
  • completed
  • failed
  • cancelled

限制說明

7. 影片翻譯 Agent API 參考

查看上傳、任務、輪詢、結果下載和錯誤碼。

GET /video-translations/{taskId}/results?expiresIn=600
GET /video-translations/{taskId}/results/files/{variant}?expiresIn=600
GET /video-translations/{taskId}/results/subtitles/{variant}
  • Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。
  • 限制說明
  • 一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。

8. 更新日期

面向 Agent、後端服務和自動化腳本的 SoulDub 影片翻譯 API 執行時參考。

POST /video-translations/{existingTaskId}/retranslate
Idempotency-Key: ${UNIQUE_IDEMPOTENCY_KEY}
  • Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。
  • 積分不換算為保證的影片分鐘數，建立任務前請以產品顯示的預估消耗為準。
  • 一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。

9. 適用範圍

Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。

  • apiBase
  • fileId
  • uploadId
  • key
  • taskId
  • idempotencyKey
  • 限制說明

10. 限制說明

一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。

  • UNAUTHORIZED
  • API_KEY_INVALID
  • RATE_LIMITED
  • INSUFFICIENT_CREDITS
  • INVALID_REQUEST
  • TASK_NOT_COMPLETED
  • RESULT_NOT_READY

11. 影片翻譯 Agent API 參考

查看上傳、任務、輪詢、結果下載和錯誤碼。

  • Agent API 認證、影片上傳、翻譯任務建立、進度查詢、結果下載和重新翻譯。
  • 一般翻譯應優先使用已發佈的 helper 腳本；本文用於 API 整合和問題排查。
  • 積分不換算為保證的影片分鐘數，建立任務前請以產品顯示的預估消耗為準。