> ## Documentation Index > Fetch the complete documentation index at: https://docs.aihubmax.com/llms.txt > Use this file to discover all available pages before exploring further. # Lipsync 唇形同步 > - Sync Lipsync 系列基于视频+音频生成唇形匹配的同步视频 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 ## OpenAPI ````yaml openapi/zh/lipsync-2.json POST /v1/videos/generations openapi: 3.1.0 info: title: Lipsync 2 version: '1.0' servers: - url: https://api.aihubmax.com security: - BearerAuth: [] paths: /v1/videos/generations: post: tags: - Video > 音画同步 summary: Lipsync 2 description: > - Sync Lipsync 系列基于视频+音频生成唇形匹配的同步视频 - 异步处理模式，使用返回的任务ID [进行查询](/pages/zh/api-manual/task-management/get-task-detail) - 生成的视频链接，有效期为24小时，请尽快保存 operationId: lipsync-2 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LipsyncGenRequest' examples: 基础口型同步: summary: 基础口型同步 value: model: lipsync-2 video_url: >- https://v3.fal.media/files/tiger/IugLCDJRIoGqvqTa-EJTr_3wg74vCqyNuQ-IiBd77MM_output.mp4 audio_url: https://fal.media/files/lion/vyFWygmZsIZlUO4s0nr2n.wav sync_mode: loop pro_模型_高级选项: summary: Pro 模型 + 高级选项 value: model: lipsync-2-pro video_url: >- https://storage.googleapis.com/falserverless/example_inputs/sync_v2_pro_video_input.mp4 audio_url: >- https://storage.googleapis.com/falserverless/example_inputs/sync_v2_pro_audio_input.mp3 sync_mode: cut_off temperature: 0.8 active_speaker: true sync_3_专业级口型同步: summary: Sync 3 专业级口型同步 value: model: sync-3 video_url: >- https://v3.fal.media/files/tiger/IugLCDJRIoGqvqTa-EJTr_3wg74vCqyNuQ-IiBd77MM_output.mp4 audio_url: https://fal.media/files/lion/vyFWygmZsIZlUO4s0nr2n.wav sync_mode: bounce responses: '200': $ref: '#/components/responses/TaskCreated' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '422': $ref: '#/components/responses/UnprocessableEntity' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': $ref: '#/components/responses/ServiceUnavailable' components: schemas: LipsyncGenRequest: type: object required: - model - video_url - audio_url properties: model: description: |- `lipsync-2`：标准质量 `lipsync-2-pro`：更高质量 `sync-3`：新一代版本，专业级质量；不支持 `temperature`、`active_speaker` examples: - lipsync-2 - lipsync-2-pro - sync-3 type: string default: lipsync-2 video_url: description: | 输入视频文件的公开 URL **说明：** - 格式：MP4 - 必须为公开可访问的 URL type: string example: >- https://v3.fal.media/files/tiger/IugLCDJRIoGqvqTa-EJTr_3wg74vCqyNuQ-IiBd77MM_output.mp4 audio_url: description: | 输入音频文件的公开 URL **说明：** - 格式：MP3 / WAV - 必须为公开可访问的 URL - 音频时长直接影响输出视频时长和计费（取决于 `sync_mode`） type: string example: https://fal.media/files/lion/vyFWygmZsIZlUO4s0nr2n.wav sync_mode: default: loop description: | 视频与音频的同步模式，决定输出视频时长 **可选值：** - `bounce` — 视频来回播放以匹配音频长度，输出时长 = 音频时长 - `loop` — 视频循环播放以匹配音频长度，输出时长 = 音频时长 - `cut_off` — 音频在视频结束时截断，输出时长 = min(视频, 音频) - `silence` — 视频末尾以静音填充，输出时长 = 视频时长 - `remap` — 重映射音频时间轴以匹配视频，输出时长 = 音频时长 type: string example: loop temperature: anyOf: - maximum: 1 minimum: 0 type: number - type: 'null' default: null description: |- 嘴部动作表现力控制，默认 0.5 **说明：** - 范围：`0.0` - `1.0` - 仅 `lipsync-2`、`lipsync-2-pro` 支持 - `sync-3` 不支持该参数 > 非必须不要传这个参数。 x-advanced: true x-unsupported-models: - sync-3 example: 0.8 active_speaker: anyOf: - type: boolean - type: 'null' default: null description: |- 启用活跃说话人检测 **说明：** - 仅 `lipsync-2`、`lipsync-2-pro` 支持 - `sync-3` 不支持该参数 > 非必须不要传这个参数。 x-advanced: true x-unsupported-models: - sync-3 example: true TaskResponse: type: object properties: created: type: integer description: 任务创建时间戳 example: 1757165031 id: type: string description: 任务ID example: task-unified-1757165031-uyujaw3d model: type: string description: 实际使用的模型名称 object: type: string description: 任务的具体类型 enum: - video.generation.task progress: type: integer description: 任务进度百分比 (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: 任务状态 enum: - pending - processing - completed - failed example: pending task_info: type: object description: 异步任务信息 properties: can_cancel: type: boolean description: 任务是否可以取消 example: true estimated_time: type: integer description: 预计完成时间（秒） example: 45 type: type: string description: 任务的输出类型 enum: - video example: video ErrorResponse400: type: object properties: error: type: object properties: message: type: string example: 请求格式错误 type: type: string example: invalid_request_error ErrorResponse401: type: object properties: error: type: object properties: message: type: string example: API密钥无效 type: type: string example: authentication_error ErrorResponse402: type: object properties: error: type: object properties: message: type: string example: 账户余额不足 type: type: string example: insufficient_quota ErrorResponse422: type: object properties: error: type: object properties: message: type: string example: 参数校验失败 type: type: string example: validation_error ErrorResponse429: type: object properties: error: type: object properties: message: type: string example: 请求频率超限 type: type: string example: rate_limit_error ErrorResponse500: type: object properties: error: type: object properties: message: type: string example: 服务器内部错误 type: type: string example: server_error ErrorResponse503: type: object properties: error: type: object properties: message: type: string example: 服务暂不可用，请稍后重试 type: type: string example: service_unavailable responses: TaskCreated: description: 任务创建成功 content: application/json: schema: $ref: '#/components/schemas/TaskResponse' BadRequest: description: 请求格式错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse400' Unauthorized: description: 未授权 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse401' PaymentRequired: description: 余额不足 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse402' UnprocessableEntity: description: 参数校验失败 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse422' TooManyRequests: description: 请求频率超限 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse429' InternalServerError: description: 服务器内部错误 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse500' ServiceUnavailable: description: 服务暂不可用 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse503' securitySchemes: BearerAuth: type: http scheme: bearer description: | ## 所有接口均需要使用Bearer Token进行认证 ## 使用时在请求头中添加： `Authorization: Bearer YOUR_API_KEY` ````