获取配音项目

GET

/v1/dubbing/project/:project_id

GET

/v1/dubbing/project/:project_id

curl https://api.elevenlabs.io/v1/dubbing/project/proj_1601kwkyxp0hfzvtmyxwqxx6mcy3

{
  "project_id": "proj_1601kwkyxp0hfzvtmyxwqxx6mcy3",
  "status": "ready",
  "revision": 3,
  "created_at": "2026-07-03T10:15:30Z",
  "updated_at": "2026-07-03T10:17:12Z",
  "reference": "Q3 marketing video",
  "source_language": "en",
  "model_id": "dubbing_v2",
  "media": {
    "filename": "promo.mp4",
    "duration_s": 42.5,
    "has_video": true,
    "mime_type": "video/mp4"
  },
  "language_ids": [
    "lang_1001kwkyxp0je6ktn4knsfrasx5s"
  ],
  "webhook_ids": [],
  "warnings": [
    {
      "type": "voices_not_permitted",
      "speaker_ids": [
        "speaker_1"
      ],
      "message": "Voice cloning was not permitted for speaker speaker_1, so a replacement voice was used."
    }
  ]
}

完整项目详情，包括其下所有语言目标的 ID。要跟踪项目何时变为 ready，建议订阅 webhook_ids，而非轮询此端点。

路径参数

project_idstring必需

要获取的配音项目标识符。

响应

成功响应

project_idstring

配音项目的唯一标识符。

statusenum

项目生命周期状态：源文件被提取前为 queued，转录期间为 preparing，转录完成且语言目标可开始处理后为 ready，或为 failed。项目不会显示为 processing，该值属于语言目标。

允许的值:

revisioninteger

每次编辑源转录文本（添加、编辑或删除片段）时递增的单调计数器。

created_atstring格式: "date-time"

创建项目的时间。

updated_atstring格式: "date-time"

项目上次更新的时间。

referencestring or null可选

创建项目时作为 reference 提供的自由格式字符串；若未提供，则为 null。

source_languagestring or null可选

BCP-47 language tag of the source media (null if auto-detected).

model_idstring or null可选

此项目每个语言目标使用的配音模型。在创建时固定，不能按语言选择。

mediaobject or null可选

源媒体元数据。在获取并解码源媒体后填充（创建后不久、项目处于 ready 前）；在此之前为 null。

language_idslist of strings可选默认为 []

此项目下目标语言的标识符。获取单个项目时会填充；创建项目时，若 target_language 创建了目标语言，也会填充。在列表响应中始终为空——请改为列出项目的目标语言。

webhook_idslist of strings可选默认为 []

当此项目及其语言达到 ready、completed 或 failed 状态时要通知的工作区 webhook ID。

errorobject or null可选

项目失败原因；除非 status 为 failed，否则为 null。对于在引入失败报告前失败的少数项目，此字段也为 null。

warningslist of objects可选

准备源内容时出现的非致命情况；没有时为空。反映最新一次准备。为特定语言配音时出现的情况会在该语言中报告。

错误

422

Unprocessable Entity Error

路径参数

请求头

响应

错误