更新目标片段
PATCHhttps://api.knoxstudio.ai/v1/dubbing/project/:project_id/language/:language_id/transcript/segment/:segment_id
修补目标译文。不计费。编辑后调用 重新生成 以重建音频。
请求
路径参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| project_id | String | 是 | 配音项目 ID。 |
| language_id | String | 是 | 语种目标 ID。 |
| segment_id | String | 是 | 片段 ID。 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | String | 是 | Bearer <token> Knox API key。也接受 xi-api-key。 |
| Content-Type | String | 是 | application/json |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| translation | String | 否 | 替换后的译文。 |
cURL 示例
curl -X PATCH https://api.knoxstudio.ai/v1/dubbing/project/proj_123/language/lang_456/transcript/segment/seg_789 \
-H "Authorization: Bearer $KNOXCHAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"translation":"你好,朋友"}'
响应
成功响应 (200)
更新后的目标片段 JSON。
错误响应
校验失败使用 HTTP 422:
{
"detail": [
{
"loc": ["body", "field"],
"msg": "…",
"type": "value_error"
}
]
}
其他错误使用 { "detail": "message" }。
| 状态 | 何时 |
|---|---|
400 | 未升级 WebSocket 就访问 WebSocket 端点。 |
401 | 缺少或无效的 API key。 |
402 | 余额不足。 |
403 | Token 无权使用该模型。 |
404 | 资源未找到。 |
422 | 校验错误。 |
429 | 超出速率限制。 |
500 | 服务器内部错误。 |