Tài liệu tham khảo SoulDub Video Translation Agent API

Tài liệu API dành cho Agent, dịch vụ backend và script tự động hóa dịch video với SoulDub.

Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.

Tham khảo về tải lên, tác vụ, theo dõi tiến trình, tải kết quả và mã lỗi.

• Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.
• Giới hạn
• Tín dụng không được quy đổi thành số phút video được đảm bảo; hãy dùng ước tính hiển thị trước khi tạo tác vụ.

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}

Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.

Tham khảo về tải lên, tác vụ, theo dõi tiến trình, tải kết quả và mã lỗi.

Authorization: Bearer ${AGENT_API_KEY}
X-API-Key: ${AGENT_API_KEY}
Content-Type: application/json
Accept: application/json

• Giới hạn
• Tín dụng không được quy đổi thành số phút video được đảm bảo; hãy dùng ước tính hiển thị trước khi tạo tác vụ.
• Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.

Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.

• POST /video-uploads/initiate
• POST /video-uploads/presign-part
• PUT {presignedUrl}
• POST /video-uploads/complete

filename: demo.mp4
contentType: video/mp4
fileSizeBytes: 342556

Tham khảo về tải lên, tác vụ, theo dõi tiến trình, tải kết quả và mã lỗi.

POST /video-translations
Idempotency-Key: ${UNIQUE_IDEMPOTENCY_KEY}

• Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.
• Tín dụng không được quy đổi thành số phút video được đảm bảo; hãy dùng ước tính hiển thị trước khi tạo tác vụ.
• Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.

Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.

GET /video-translations/{taskId}

• pending
• processing
• completed
• failed
• cancelled

Giới hạn

Tham khảo về tải lên, tác vụ, theo dõi tiến trình, tải kết quả và mã lỗi.

GET /video-translations/{taskId}/results?expiresIn=600
GET /video-translations/{taskId}/results/files/{variant}?expiresIn=600
GET /video-translations/{taskId}/results/subtitles/{variant}

• Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.
• Giới hạn
• Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.

Tài liệu API dành cho Agent, dịch vụ backend và script tự động hóa dịch video với SoulDub.

POST /video-translations/{existingTaskId}/retranslate
Idempotency-Key: ${UNIQUE_IDEMPOTENCY_KEY}

• Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.
• Tín dụng không được quy đổi thành số phút video được đảm bảo; hãy dùng ước tính hiển thị trước khi tạo tác vụ.
• Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.

Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.

• apiBase
• fileId
• uploadId
• key
• taskId
• idempotencyKey
• Giới hạn

Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.

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

Tham khảo về tải lên, tác vụ, theo dõi tiến trình, tải kết quả và mã lỗi.

• Xác thực Agent API, tải video lên, tạo tác vụ dịch, theo dõi tiến trình, tải kết quả và dịch lại.
• Với các lượt dịch thông thường, hãy ưu tiên script helper đã phát hành; tài liệu này dành cho tích hợp API và gỡ lỗi.
• Tín dụng không được quy đổi thành số phút video được đảm bảo; hãy dùng ước tính hiển thị trước khi tạo tác vụ.