> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mountsea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 下载视频

> 从音频生成带可视化效果的视频

将音频曲目转换为带视觉效果的视频。可从预设的可视化风格中选择。

<Info>
  这是一个异步任务。响应中包含一个 `taskId` — 使用[获取任务状态](/zh/api-reference/producer/task)来轮询获取视频下载链接。
</Info>

## 可用预设

| 预设       | 描述               |
| -------- | ---------------- |
| `modern` | 现代风格，动态可视化效果（默认） |
| `player` | 音乐播放器风格界面        |
| `simple` | 简洁、极简设计          |

<Tip>
  视频生成比音频下载耗时更长 — 预计 2-5 分钟，具体取决于曲目时长。输出为 1080p MP4。
</Tip>


## OpenAPI

````yaml POST /producer/download-video
openapi: 3.0.0
info:
  title: Producer - AI Music Generation
  description: >-
    Generate music with Google DeepMind's Lyria 3 Pro model. Supports
    text-to-music, lyrics-to-music, and image-guided generation with stem
    separation and multi-format export.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: producer
    description: >-
      Music generation, audio upload, stem separation, and export endpoints
      powered by Lyria 3 Pro
paths:
  /producer/download-video:
    post:
      tags:
        - producer
      summary: 下载视频
      description: >-
        将音频生成视频并下载（支持 modern/player/simple 预设）。返回 taskId，使用 /producer/tasks
        接口轮询获取结果
      operationId: ApiPublicController_downloadVideo
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DownloadVideoDto'
      responses:
        '200':
          description: 任务创建成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
        '201':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    DownloadVideoDto:
      type: object
      properties:
        audioId:
          type: string
          description: 音频 ID
          example: 9719e086-576a-4830-a0f2-7c9424460d6d
        preset:
          type: string
          enum:
            - modern
            - player
            - simple
          description: 视频预设样式
          default: modern
          example: modern
      required:
        - audioId
    TaskIdDto:
      type: object
      properties:
        taskId:
          type: string
          description: 任务 ID，用于后续查询结果
      required:
        - taskId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````