Skip to main content
获取翻译状态

获取翻译状态

检索翻译项目的当前状态。使用此端点轮询进度,并在处理完成后获取翻译后的视频 URL。

请求

标头

string
必填
您的 VoiceCheap API 密钥。请从 app.voicecheap.ai/page-api 获取。

路径参数

string
必填
Start Translation 端点返回的翻译项目的唯一标识符。

响应

响应结构根据翻译状态而变化。

通用字段

string
必填
项目的唯一标识符
string
必填
项目名称
string
必填
原始上传视频/音频文件的 URL
string
必填
检测到或指定的原始语言
string
必填
翻译的目标语言
number
必填
内容时长(秒)
number
必填
项目创建时的 Unix 时间戳
string
必填
创建该项目的 API 工作流:translationtranscription
string
必填
源转录状态:processingsuccessfailed。此信号与配音完成情况无关。
object
必填
可用的标准化转录。
string
当前报告的翻译版本的翻译工作标识符。
string
当前报告的翻译版本的翻译版本标识符。
string
当前项目步骤。在创建或转录期间,这反映了活跃的创建步骤。 示例包括 downloading_contentcontent_validationtranscription_processing。 一旦配音开始,它可能会切换到活跃的配音步骤,例如 smart_syncaudio_assemblingstatus: processing 不与 actualProgressStep: done 配对。
number
项目创建/转录的近似进度百分比 (0-100)
string
目标语言的当前配音步骤(例如 smart_syncaudio_enhancementvideo_upload
number
配音的近似进度百分比 (0-100)
string
必填
翻译的当前状态:processingsuccessfailed

Lip Sync 字段

当请求口型同步时,响应包含一个额外的 lipSync 对象:
object
口型同步状态和输出详情(仅在请求口型同步时出现)
当请求口型同步时,翻译将保留在 processing 中,直到 lipSync.statusCOMPLETED。如果口型同步失败,状态将变为 failederror.codeLIPSYNC_FAILED。当口型同步成功时,从 lipSync.videoUrl 读取口型同步后的资产;translatedVideoUrl 是口型同步叠加之前的翻译视频输出。
当您需要完整的翻译版本历史记录或完整的口型同步历史记录时,请使用 GET /v1/projects/{projectId}

成功响应字段

对于翻译工作流,当 statussuccess 时,会包含以下字段。仅转录工作流会达到 success,且不包含翻译后的媒体字段。
string
下载翻译视频文件的 URL
string
单独下载翻译音频文件的 URL

失败响应字段

statusfailed 时,会包含以下附加字段:
object
错误详情

示例

响应示例

处理状态

处理状态(已请求 Lip Sync)

成功状态

成功状态(Lip Sync 已完成)

失败状态

轮询最佳实践

建议轮询间隔: 10-30 秒翻译时间因视频长度和复杂程度而异。对于典型的 2 分钟视频,预计处理时间为 2-5 分钟。
速率限制: 每分钟 30 个请求避免轮询频率高于每 2 秒一次,以保持在速率限制范围内。

错误