You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/API 参考/媒体处理/ListAITranslationProject - 获取 AI 翻译项目列表
ListAITranslationProject - 获取 AI 翻译项目列表
最近更新时间：2025.06.05 15:38:12首次发布时间：2025.06.05 15:38:12
我的收藏
有用
有用
无用
无用

调用 ListAITranslationProject 接口查询指定空间中的 AI 翻译项目列表，支持按项目状态过滤和分页查询。返回结果包括输入和输出视频信息。

注意事项

  • 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

请求地址：https://vod.volcengineapi.com?Action=ListAITranslationProject&Version=2025-01-01

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数
类型
是否必选
示例值
描述
Action
String
是
ListAITranslationProject
接口名称。当前 API 的名称为 ListAITranslationProject。
Version
String
是
2025-01-01
接口版本。当前 API 的版本为 2025-01-01。
SpaceName
String
是
test

点播空间名。您可通过以下方式获取空间名称：

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。
PageNumber
Integer
否
1
分页查询的页码编号，默认值为 1。
PageSize
String
否
10
每页返回的任务数量，默认值为 10。
StatusFilter
String
否
InProcessing,ProcessSucceed

任务状态，多个状态可用逗号分隔。不传返回所有状态的任务。支持的状态取值：

  • InProcessing：处理中
  • ProcessSucceed：处理完成
  • ProcessFailed：处理失败
  • InExporting：导出中
  • ExportSucceed：导出完成
  • ExportFailed：导出失败
ProjectIdOrTitleFilter
String
否
project123

项目 ID 或项目名称。您可通过以下方式获取项目 ID：

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数
类型
示例值
描述
Projects
Object[]
-
项目信息列表
ProjectId
String
684038d6b71c9005b266fefe
项目 ID
ProjectVersion
String
01c4fa5da3d648a588a46f81e282b100
项目版本
WorkflowId
String
684038d6b71c9005b266fefd
工作流 ID
CreatedAt
String
1749039318
项目创建时间，Unix 时间戳，精度为秒。
UpdatedAt
String
1749039973
项目更新时间，Unix 时间戳，精度为秒。
Status
String
ProcessSucceed

项目状态，取值如下：

  • InProcessing：处理中
  • ProcessSucceed：处理完成
  • ProcessFailed：处理失败
  • InExporting：导出中
  • ExportSucceed：导出完成
  • ExportFailed：导出失败
InputVideoPosterUrl
String
https://example.bytedance.com/tos-vod-cn-v-f724fac4091119c6/oM90fAzdSEvgtE***QQBVVfSWAJmx4ZH~noop.jpeg
输入视频封面 URL
InputVideoTitle
String
example.mp4
输入视频名称
TranslationTypeList
String[]
["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]

执行的翻译类型组合，支持以下选项：

  • ["SubtitleTranslation"]：仅文本翻译。
  • ["SubtitleTranslation","VoiceTranslation"]：文本和语音翻译。
  • ["SubtitleTranslation","VoiceTranslation", "FacialTranslation"]：文本、语音和面容翻译。

说明

翻译类型详细介绍请见声影智译。

InputVideo
Object
-
输入视频信息
IsAudio
Boolean
true
是否为音频
Uri
String
tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4
文件存储路径
Vid
String
v0299fg***4d103gsqljht10tatbreg
文件 Vid。仅在 InputVideo 和 OutputVideo 中此字段有值。
DurationSecond
Double
159.104
文件时长，单位为秒
Url
String
https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4
文件访问 URL
OutputVideo
Object
-
输出视频信息
IsAudio
Boolean
true
是否为音频
Uri
String
tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4
文件存储路径
Vid
String
v0299fg***4d103gsqljht10tatbreg
文件 Vid。仅在 InputVideo 和 OutputVideo 中此字段有值。
DurationSecond
Double
159.104
文件时长，单位为秒
Url
String
https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4
文件访问 URL
SourceBlueprints
Object[]
-
源蓝图
Id
String
684038d6b71c9005b266feff
蓝图 ID
Language
String
zh

语言，取值如下：

  • en：英文
  • ja：日文
  • es：西班牙语
  • pt：葡萄牙语
  • zh：中文
  • id：印尼语
ProjectId
String
684038d6b71c9005b266fefe
项目 ID
TranslationType
String
source

翻译类型，取值如下：

  • source：源语言
  • target：目标语言
TargetBlueprints
Object[]
-
目的蓝图
Id
String
684038d6b71c9005b266feff
蓝图 ID
Language
String
zh

语言，取值如下：

  • en：英文
  • ja：日文
  • es：西班牙语
  • pt：葡萄牙语
  • zh：中文
  • id：印尼语
ProjectId
String
684038d6b71c9005b266fefe
项目 ID
TranslationType
String
source

翻译类型，取值如下：

  • source：源语言
  • target：目标语言
OperatorConfig
Object
-
操作配置
SubtitleRecognitionConfig
Object
-
字幕识别配置
RecognitionType
String
OCR

字幕识别类型，取值如下：

  • OCR：视频画面文字识别
  • ASR：语音识别
默认为 OCR。
ErrorMsg
String
ErrorMsg
错误信息
ErrorCode
Integer
0

错误码：

  • 0：任务执行成功
  • 500200：回调状态为空
  • 500210：AI 翻译后处理失败
  • 500100：AI 翻译工作流内部错误
  • 500110：背景音分离失败
  • 500120：字幕文本翻译失败
  • 500130：语音翻译失败
  • 500140：面容翻译失败
TotalCount
Integer
2
项目总数
PageSize
Integer
10
每页显示的项目数量
PageNumber
Integer
1
当前查询的页码

请求示例

https://vod.volcengineapi.com?Action=ListAITranslationProject&Version=2025-01-01&SpaceName=test

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "ListAITranslationProject",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "Projects": [
      {
        "ProjectId": "684038d6b71c9005b266fefe",
        "ProjectVersion": "01c4fa5da3d648a588a46f81e282b100",
        "WorkflowId": "684038d6b71c9005b266fefd",
        "CreatedAt": "1749039318",
        "UpdatedAt": "1749039973",
        "Status": "ProcessSucceed",
        "InputVideoTitle": "example.mp4",
        "TranslationTypeList": [
          "SubtitleTranslation",
          "VoiceTranslation",
          "FacialTranslation"
        ],
        "InputVideo": {
          "Uri": "tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4",
          "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
          "Vid": "v0299fg***4d103gsqljht10tatbreg",
          "IsAudio": false,
          "DurationSecond": 159.104
        },
        "OutputVideo": {
          "Uri": "tos-vod-cn-v-f724fac4091119c6/败给月光1.mp4",
          "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
          "Vid": "v0299fg***4d103gsqljht10tatbreg",
          "IsAudio": false,
          "DurationSecond": 159.104
        },
        "SourceBlueprints": [
          {
            "Id": "684038d6b71c9005b266feff",
            "Language": "zh",
            "ProjectId": "684038d6b71c9005b266fefe",
            "TranslationType": "source"
          }
        ],
        "TargetBlueprints": [
          {
            "Id": "684038d6b71c9005b266ff00",
            "Language": "en",
            "ProjectId": "684038d6b71c9005b266fefe",
            "TranslationType": "target"
          }
        ],
        "OperatorConfig": {
          "SubtitleRecognitionConfig": {
            "RecognitionType": "OCR"
          }
        },
        "ErrorMsg": "ErrorMsg",
        "ErrorCode": 0
      }
    ],
    "TotalCount": 1,
    "PageSize": 10,
    "PageNumber": 1
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。