跳转到主要内容
POST
提交视频翻译任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
视频翻译会转写一个视频或音频文件中的语音并进行翻译,然后返回配音视频。可用时还会返回目标语言的字幕文件。适用于本地化口播视频、教程和短视频内容。

模型

  • poyo-ai/video-translator — 翻译并配音一个视频或音频文件

必填参数

  • video_urls (array of strings):只能传一个视频或音频 URL。支持 MP4、MOV、AVI、MP3 或 WAV,最大 400 MB、最长 6 分钟。
  • source_language (string):源文件中的口语语言,例如 en。不接受 auto。
  • target_language (string):目标语言,例如 ja。

输出

任务完成后,files 中返回译后视频,file_type: video。如果生成了字幕轨,还会返回目标语言的 SRT 文件,file_type: other。较长的文件可能分段处理,每一段都会各自增加视频和字幕条目。

示例

  • 将英语视频翻译成日语 — 设置 video_urls、source_language、target_language。

注意事项

  • 每个任务只接受一个文件。
  • source_language 必须是明确的语言。视频翻译不支持语言自动检测。
  • 超过 6 分钟或大于 400 MB 的文件在提交时会被拒绝。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

公开的模型标识。

可用选项:
poyo-ai/video-translator
input
object
必填
callback_url
string<uri>

可选的 Webhook URL,用于接收任务完成或失败通知。

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填