feat: #1796 MediaKit 对口型后端对接 #1801

Merged

auto-approve-bot merged 5 commits from feat/mediakit-lipsync-1796 into develop 2026-09-08 16:47:58 +08:00

Conversation 2 Commits 5 Files Changed 10

+1462 -1

xiaoxia commented 2026-09-08 16:23:12 +08:00

Owner

Copy Link

Copy Source

概述

对接火山引擎 AI MediaKit 对口型 API，实现视频+音频→口型对齐口播视频的异步任务。

改动

新增文件

• apps/api/app/services/mediakit_client.py — MediaKit API 客户端
• apps/api/app/services/lipsync_service.py — 对口型业务逻辑
• apps/api/app/schemas/lipsync.py — 请求/响应 Schema
• apps/api/app/api/routes/lipsync.py — RESTful API 路由
• alembic/versions/071_add_lipsync_jobs_table.py — 数据库迁移
• tests/unit/test_mediakit_client.py — 客户端测试（13个）
• tests/unit/test_lipsync_routes.py — 路由/Service 测试（17个）

修改文件

• packages/adapters/sqlalchemy_impl/models.py — 新增 LipsyncJobModel
• apps/api/app/api/router.py — 注册 lipsync 路由

API

方法	路径	说明
POST	/api/v1/lipsync/jobs	提交对口型任务
GET	/api/v1/lipsync/jobs	任务列表
GET	/api/v1/lipsync/jobs/{id}	任务详情
POST	/api/v1/lipsync/jobs/{id}/refresh	刷新状态
POST	/api/v1/lipsync/jobs/{id}/cancel	取消任务

测试

• 30 个新增测试全过
• 不破坏现有功能（65 测试全过）

Closes #1796

## 概述 对接火山引擎 AI MediaKit 对口型 API，实现视频+音频→口型对齐口播视频的异步任务。 ## 改动 ### 新增文件 - `apps/api/app/services/mediakit_client.py` — MediaKit API 客户端 - `apps/api/app/services/lipsync_service.py` — 对口型业务逻辑 - `apps/api/app/schemas/lipsync.py` — 请求/响应 Schema - `apps/api/app/api/routes/lipsync.py` — RESTful API 路由 - `alembic/versions/071_add_lipsync_jobs_table.py` — 数据库迁移 - `tests/unit/test_mediakit_client.py` — 客户端测试（13个） - `tests/unit/test_lipsync_routes.py` — 路由/Service 测试（17个） ### 修改文件 - `packages/adapters/sqlalchemy_impl/models.py` — 新增 LipsyncJobModel - `apps/api/app/api/router.py` — 注册 lipsync 路由 ## API | 方法 | 路径 | 说明 | |------|------|------| | POST | /api/v1/lipsync/jobs | 提交对口型任务 | | GET | /api/v1/lipsync/jobs | 任务列表 | | GET | /api/v1/lipsync/jobs/{id} | 任务详情 | | POST | /api/v1/lipsync/jobs/{id}/refresh | 刷新状态 | | POST | /api/v1/lipsync/jobs/{id}/cancel | 取消任务 | ## 测试 - 30 个新增测试全过 - 不破坏现有功能（65 测试全过） Closes #1796

xiaoxia added 1 commit 2026-09-08 16:23:12 +08:00

feat: #1796 MediaKit 对口型后端对接 ... 5493c38dd9

- MediaKitClient: 封装火山引擎 AI MediaKit 对口型 API
  - POST /api/v1/tools/lip-sync 提交任务
  - GET /api/v1/tasks/{task_id} 查询状态
  - 错误处理：超时/网络/HTTP 错误统一 MediaKitError
  - 未配置 API Key 时自动降级
- LipsyncJobModel: 对口型任务 ORM 模型
  - 用户隔离 + 项目关联
  - 状态流转: pending → submitted → completed/failed
- LipsyncService: 业务逻辑层
  - create_job / get_job / list_jobs / refresh_job_status / cancel_job
  - 分页查询 + 状态过滤 + 用户隔离
- RESTful API: /api/v1/lipsync/jobs
  - POST   /jobs           提交对口型任务
  - GET    /jobs           任务列表（分页+过滤）
  - GET    /jobs/{id}      任务详情
  - POST   /jobs/{id}/refresh  刷新状态
  - POST   /jobs/{id}/cancel   取消任务
- Schema: 输入校验（视频仅 MP4，音频 mp3/aac/wav/m4a/flac）
- 数据库迁移: 071_add_lipsync_jobs_table
  - lipsync_jobs 表 + 复合索引（user_id+status, project_id+user_id）
- 30 个单元测试（13 客户端 + 17 路由/Service）
- 不破坏现有功能（65 测试全过）

gitea-actions bot commented 2026-09-08 16:24:57 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

auto-approve-bot added 1 commit 2026-09-08 16:25:17 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 1380dc21de

xiaoxia added 1 commit 2026-09-08 16:27:51 +08:00

fix: 修复迁移链 — 071 down_revision 指向 070_add_scripts ea59f94267

xiaoxia added 1 commit 2026-09-08 16:31:19 +08:00

fix: lipsync 路由 get_db → get_db_session 4d2ab6872e

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

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

auto-approve-bot merged commit f7825e3956 into develop 2026-09-08 16:47:58 +08:00

auto-approve-bot deleted branch feat/mediakit-lipsync-1796 2026-09-08 16:47:58 +08:00

gitea-actions bot commented 2026-09-08 16:48:34 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

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 xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1801