fix: AI数字人对口型接口对齐后端新参数 video_url (#1809 补充) #1816

Merged

auto-approve-bot merged 1 commits from fix/ai-avatar-lipsync-api-align into develop 2026-09-09 10:35:50 +08:00

Conversation 4 Commits 1 Files Changed 2

+23 -3

xiaoxia commented 2026-09-09 10:29:40 +08:00

Owner

Copy Link

Copy Source

背景

后端已完成 /api/v1/lipsync/jobs 接口调整（PR #1814，staging 已部署），前端参数对齐。

后端新参数

{
  "video_url": "https://...",  // 用 video_asset_id 调素材接口拿 file_url
  "voice_id": "longxiaochun_v3", // 预设音色 ID 或克隆音色 profile UUID
  "script_text": "脚本文本",
  "enable_video_loop": false,
  "project_id": ""
}

前端改动

• createLipsyncJob 参数 video_asset_id → video_url
• 新增 getAssetById：先按素材 id 查 /assets/{id} 拿 file_url 再传给后端
• voice_id + script_text 直接传后端（后端内部调 TTS）
• 删除前端 video_asset_id 传参，全工程残留已清零
• file_url 为空时弹明确 toast，避免静默失败

不动

• UI 布局
• 其他功能（渲染提交、轮询、B-roll 等）

验证

• tsc 0 / ESLint 0 / Prettier
• 后端 schema 字段完全对应：apps/api/app/schemas/lipsync.py 第 42 行 video_url: str

## 背景 后端已完成 /api/v1/lipsync/jobs 接口调整（PR #1814，staging 已部署），前端参数对齐。 ## 后端新参数 ```json { "video_url": "https://...", // 用 video_asset_id 调素材接口拿 file_url "voice_id": "longxiaochun_v3", // 预设音色 ID 或克隆音色 profile UUID "script_text": "脚本文本", "enable_video_loop": false, "project_id": "" } ``` ## 前端改动 - `createLipsyncJob` 参数 `video_asset_id` → `video_url` - 新增 `getAssetById`：先按素材 id 查 `/assets/{id}` 拿 `file_url` 再传给后端 - `voice_id` + `script_text` 直接传后端（后端内部调 TTS） - 删除前端 `video_asset_id` 传参，全工程残留已清零 - `file_url` 为空时弹明确 toast，避免静默失败 ## 不动 - UI 布局 - 其他功能（渲染提交、轮询、B-roll 等） ## 验证 - tsc 0 / ESLint 0 / Prettier - 后端 schema 字段完全对应：`apps/api/app/schemas/lipsync.py` 第 42 行 `video_url: str`

xiaoxia added 1 commit 2026-09-09 10:29:40 +08:00

fix: AI数字人对口型接口对齐后端新参数 video_url (#1809 补充) ... deea31dc07

- createLipsyncJob 参数 video_asset_id → video_url（后端 schema 已改）
- 新增 getAssetById：先按素材 id 查 /assets/{id} 拿 file_url 再传给后端
- voice_id/script_text 直接传后端（后端内部调 TTS）
- 删除前端 video_asset_id 传参，全工程 video_asset_id 残留已清零
- 新增 file_url 为空时的明确 toast 提示，避免静默失败
- UI/其他功能不动

gitea-actions bot commented 2026-09-09 10:31:04 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot approved these changes 2026-09-09 10:31:48 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-09-09 10:31:48 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot merged commit 547561f473 into develop 2026-09-09 10:35:50 +08:00

auto-approve-bot deleted branch fix/ai-avatar-lipsync-api-align 2026-09-09 10:35:51 +08:00

gitea-actions bot commented 2026-09-09 10:36:30 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

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#1816