fix: #1809 对口型接口参数调整，后端内部调TTS合成音频 #1814

Merged

auto-approve-bot merged 2 commits from fix/lipsync-api-params-1809 into develop 2026-09-09 10:11:27 +08:00

Conversation 2 Commits 2 Files Changed 4

+271 -72

xiaoxia commented 2026-09-09 10:01:54 +08:00

Owner

Copy Link

Copy Source

问题

前端传 {voice_id, script_text, video_asset_id}，后端 /api/v1/lipsync/jobs 要求 {video_url, audio_url}，导致 422 报错。

改动

• Schema: CreateLipsyncJobRequest 改为接收 {voice_id, script_text, video_url}，移除 audio_url
• Service: create_job 内部调 CosyVoice TTS 合成音频，生成 audio_url 后提交 MediaKit
• Route: 注入 CosyVoiceService + voice_clone_profile_repository，支持克隆音色 profile UUID 解析
• TTS 失败时创建 failed 记录并返回 502

前端对接说明

新请求参数：

{
  "video_url": "https://...",  // 前端用 video_asset_id 换取
  "voice_id": "longxiaochun_v3",  // 预设音色ID 或 克隆音色profile UUID
  "script_text": "要合成的脚本文本",
  "enable_video_loop": false,
  "project_id": ""
}

video_url 由前端用 video_asset_id 换好再传，voice_id 支持预设音色和克隆音色。

测试

• 21 个 lipsync 测试更新通过
• 57 个关联测试（ai_avatar_render、mediakit）无回归

Closes #1809

## 问题 前端传 `{voice_id, script_text, video_asset_id}`，后端 `/api/v1/lipsync/jobs` 要求 `{video_url, audio_url}`，导致 422 报错。 ## 改动 - **Schema**: `CreateLipsyncJobRequest` 改为接收 `{voice_id, script_text, video_url}`，移除 `audio_url` - **Service**: `create_job` 内部调 CosyVoice TTS 合成音频，生成 `audio_url` 后提交 MediaKit - **Route**: 注入 `CosyVoiceService` + `voice_clone_profile_repository`，支持克隆音色 profile UUID 解析 - TTS 失败时创建 failed 记录并返回 502 ## 前端对接说明 新请求参数： ```json { "video_url": "https://...", // 前端用 video_asset_id 换取 "voice_id": "longxiaochun_v3", // 预设音色ID 或 克隆音色profile UUID "script_text": "要合成的脚本文本", "enable_video_loop": false, "project_id": "" } ``` `video_url` 由前端用 `video_asset_id` 换好再传，`voice_id` 支持预设音色和克隆音色。 ## 测试 - 21 个 lipsync 测试更新通过 - 57 个关联测试（ai_avatar_render、mediakit）无回归 Closes #1809

xiaoxia added 1 commit 2026-09-09 10:01:54 +08:00

fix: #1809 对口型接口参数调整，后端内部调TTS合成音频 ... 6167e4c865

- Schema: CreateLipsyncJobRequest 改为接收 {voice_id, script_text, video_url}
- Service: create_job 内部调 CosyVoice 合成音频，生成 audio_url 后提交 MediaKit
- Route: 注入 CosyVoiceService + voice_clone_profile_repository，支持克隆音色解析
- TTS 失败时创建 failed 记录并返回 502
- 21 个测试更新通过，57 个关联测试无回归

gitea-actions bot commented 2026-09-09 10:03:11 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1814
预览链接	https://pr-1814.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1814 | | 预览链接 | [https://pr-1814.preview.xiaoxiajianji.com](https://pr-1814.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot added 1 commit 2026-09-09 10:04:16 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 46f4de9f3b

auto-approve-bot merged commit c954e334e6 into develop 2026-09-09 10:11:27 +08:00

auto-approve-bot deleted branch fix/lipsync-api-params-1809 2026-09-09 10:11:27 +08:00

gitea-actions bot commented 2026-09-09 10:11:48 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1814 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1814 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

xiaoxia referenced this pull request 2026-09-09 11:04:01 +08:00

fix: #1809 补充 对口型接口参数校验返回400而非500 #1818

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1814