Skip to main content
获取翻译状态

获取翻译状态

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

请求

标头

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

路径参数

string
必填
从 Start Translation 端点返回的翻译项目的唯一标识符。
用创建项目创建的项目,一旦调用项目配音,就会切换到 translation 流程:此接口随后跟踪最新的配音运行。

响应

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

通用字段

string
必填
项目的唯一标识符
string
必填
项目名称
string
必填
原始上传视频/音频文件的 URL
string
必填
检测到或指定的原始语言
string
必填
翻译的目标语言
number
必填
内容时长(秒)
number
必填
项目创建时的 Unix 时间戳
string
必填
创建该项目的 API 工作流:translation 或 transcription。
string
必填
源转录状态:processing、success 或 failed。此信号与配音完成情况无关。
object
必填
可用的标准化转录。
string
当前报告的翻译版本的翻译工作标识符。
string
当前报告的翻译版本的翻译版本标识符。
string
当前项目步骤。在创建或转录期间,这反映了活跃的创建步骤。 示例包括 downloading_content、content_validation 和 transcription_processing。 一旦配音开始,它可能会切换到活跃的配音步骤,例如 smart_sync 或 audio_assembling。 后续步骤(例如口型同步)仍在运行时,status: processing 可能与 actualProgressStep: done 同时出现。
number
项目创建/转录的近似进度百分比 (0-100)
string
目标语言的当前配音步骤(例如 smart_sync、audio_enhancement、video_upload)
number
配音的近似进度百分比 (0-100)
string
必填
翻译的当前状态:processing、success 或 failed

Lip Sync 字段

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

成功响应字段

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

失败响应字段

当 status 为 failed 时,会包含以下附加字段:
object
错误详情

示例

响应示例

处理状态

处理状态(已请求 Lip Sync)

成功状态

成功状态(Lip Sync 已完成)

失败状态

轮询最佳实践

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

错误