调用 GetAITranslationProject 接口获取 AI 翻译项目的详细信息，包括项目基本信息和附加信息（说话者信息、源语言对话文本和目标语言对话文本等）。

注意事项 #

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

请求说明 #

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

调试 #

请求参数 #

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

返回参数 #

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

请求示例 #

https://vod.volcengineapi.com?Action=GetAITranslationProject&Version=2025-01-01&SpaceName=video-edit-space&ProjectId=684038d6b71c***5b266fefe&Additions=Speakers,SourceUtterances,SourceTracks,SourceClips,TargetUtterances,TargetTracks,TargetClips,BackgroundClip

返回示例 #

{
  "ResponseMetadata": {
    "RequestId": "20230604110420****100232280022D31",
    "Action": "GetAITranslationProject",
    "Version": "2025-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "ProjectInfo": {
      "ProjectId": "684038d6***c9005b266fefe",
      "ProjectVersion": "01c4fa5da***48a588a46f81e282b100",
      "WorkflowId": "684038d6***c9005b266fefd",
      "CreatedAt": "1749039318",
      "UpdatedAt": "1749039973",
      "Status": "ProcessSucceed",
      "InputVideoTitle": "example.mp4",
      "TranslationTypeList": [
        "SubtitleTranslation",
        "VoiceTranslation",
        "FacialTranslation"
      ],
      "BackgroundAudio": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "ForegroundAudio": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "InputVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "PreviewVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "PreviewVideoMuted": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "OutputVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "VoiceTranslationVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "FacialTranslationVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "Speakers": [
        {
          "Id": "68403b65e***4cc4835c80f4",
          "Name": "Speaker 1",
          "Voice": "zh_female_***_bigtts",
          "ProjectId": "684038d***1c9005b266fefe",
          "CurrentVoice": "zh_male_***_bigtts"
        }
      ],
      "SourceUtterances": [
        {
          "Id": "68403b65***64cc4835c8141",
          "Text": "文本内容",
          "ClipId": "68403b65ef364cc4835c8104",
          "Status": "online",
          "SourceId": "000000000000000000000000",
          "ProjectId": "684038d6b71c9005b266fefe",
          "SpeakerId": "68403b65***64cc4835c80f4",
          "BlueprintId": "684038d6b71c9005b266feff",
          "TranslationType": "source",
          "IsFacialTranslation": true
        }
      ],
      "TargetUtterances": [
        {
          "Id": "68403b65***64cc4835c8141",
          "Text": "文本内容",
          "ClipId": "68403b65ef364cc4835c8104",
          "Status": "online",
          "SourceId": "000000000000000000000000",
          "ProjectId": "684038d6b71c9005b266fefe",
          "SpeakerId": "68403b65***64cc4835c80f4",
          "BlueprintId": "684038d6b71c9005b266feff",
          "TranslationType": "target",
          "IsFacialTranslation": true
        }
      ],
      "SourceTracks": [
        {
          "Id": "68403b65ef364cc4835c80f9",
          "SpeakerId": "68403b65ef364cc4835c80f4",
          "BlueprintId": "684038d6b71c9005b266feff",
          "TranslationType": "source"
        }
      ],
      "TargetTracks": [
        {
          "Id": "68403b65ef364cc4835c80f9",
          "SpeakerId": "68403b65ef364cc4835c80f4",
          "BlueprintId": "684038d6b71c9005b266feff",
          "TranslationType": "target"
        }
      ],
      "SourceBlueprints": [
        {
          "Id": "684038d6b71c9005b266feff",
          "Language": "zh",
          "ProjectId": "684038d6b71c9005b266fefe",
          "TranslationType": "source"
        }
      ],
      "TargetBlueprints": [
        {
          "Id": "684038d6b71c9005b266feff",
          "Language": "zh",
          "ProjectId": "684038d6b71c9005b266fefe",
          "TranslationType": "target"
        }
      ],
      "SourceClips": [
        {
          "Id": "68403b65ef364cc4835c810b",
          "Trim": {
            "End": 1100,
            "Start": 200
          },
          "Volume": 100,
          "TrackId": "68403b65ef364cc4835c80fa",
          "ClipAudio": {
            "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
            "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
            "Vid": "v0299fg***4d103gsqljht10tatbreg",
            "IsAudio": true,
            "FileName": "video.mp4",
            "DurationSecond": 159.104
          },
          "ClipVideo": {
            "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
            "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
            "Vid": "v0299fg***4d103gsqljht10tatbreg",
            "IsAudio": true,
            "FileName": "video.mp4",
            "DurationSecond": 159.104
          },
          "TranslationType": "source"
        }
      ],
      "TargetClips": [
        {
          "Id": "68403b65ef364cc4835c810b",
          "Trim": {
            "End": 1100,
            "Start": 200
          },
          "Volume": 100,
          "TrackId": "68403b65ef364cc4835c80fa",
          "ClipAudio": {
            "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
            "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
            "Vid": "v0299fg***4d103gsqljht10tatbreg",
            "IsAudio": true,
            "FileName": "video.mp4",
            "DurationSecond": 159.104
          },
          "ClipVideo": {
            "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
            "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
            "Vid": "v0299fg***4d103gsqljht10tatbreg",
            "IsAudio": true,
            "FileName": "video.mp4",
            "DurationSecond": 159.104
          },
          "TranslationType": "target"
        }
      ],
      "BackgroundClip": {
        "Id": "684038d6b71c9005b266feff",
        "Language": "zh",
        "ProjectId": "684038d6b71c9005b266fefe",
        "TranslationType": "source"
      },
      "OperatorConfig": {
        "SubtitleRecognitionConfig": {
          "RecognitionType": "OCR"
        }
      },
      "ErrorMsg": "ErrorMsg",
      "ErrorCode": 0,
      "ErasedSubtitleVideo": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "InputSubtitle": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      },
      "OutputSubtitle": {
        "Uri": "tos-vod-cn-v-f724fac40***19c6/败给月光1.mp4",
        "Url": "https://example.volcvideo.com/%E8%B4%A5%E7%BB%99%E6%9C%88%E5%85%891.mp4",
        "Vid": "v0299fg***4d103gsqljht10tatbreg",
        "IsAudio": true,
        "FileName": "video.mp4",
        "DurationSecond": 159.104
      }
    }
  }
}

项目处理失败排查 #

当 ErrorCode 非 0 时，请先记录 ProjectId、WorkflowId、ErrorCode 和 ErrorMsg，再结合错误发生阶段排查。以下为通用排查建议，不代表已确定的故障原因：

• 500200：核对当前项目状态及 ErrorMsg，向技术支持提供工作流 ID，以排查回调状态缺失的原因。
• 500100、500210：向技术支持提供上述信息，排查工作流内部或后处理阶段的错误。
• 500110、500120、500130、500140：分别对应背景音分离、字幕文本翻译、语音翻译、面容翻译阶段。结合 ErrorMsg 核对该阶段的输入和配置；若无法定位，向技术支持提供项目及工作流信息。

错误码 #

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