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

# Video to Music

> Generate background music from video content

Automatically generate background music that matches your video content. The AI analyzes the video and creates music that fits the mood, pace, and transitions.

<Info>
  This is an async task. The response contains a `taskId` — use [Get Task Status](/api-reference/eleven/task) to poll for the generated audio.
</Info>

## Limits

* Up to **10** video URLs per request
* Total file size: max **200 MB**
* Total video duration: max **600 seconds** (10 minutes)

<Tip>
  Add a `description` and `tags` to guide the AI toward the desired style. For example, `"description": "Upbeat background music for a travel vlog"` with `"tags": ["upbeat", "cinematic"]`.
</Tip>


## OpenAPI

````yaml POST /eleven/video-to-music
openapi: 3.0.0
info:
  title: Eleven AI
  description: API documentation for Eleven AI
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.mountsea.ai
    description: API Gateway
security: []
tags:
  - name: eleven
    description: ''
paths:
  /eleven/video-to-music:
    post:
      tags:
        - eleven
      summary: 视频配乐
      description: |-
        对应 ElevenLabs POST /v1/music/video-to-music。
        根据视频内容生成背景音乐。返回 taskId，使用 GET /eleven/tasks 轮询获取结果
      operationId: ApiPublicController_videoToMusic
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VideoToMusicDto'
      responses:
        '200':
          description: 任务创建成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskIdDto'
      security:
        - bearerAuth: []
components:
  schemas:
    VideoToMusicDto:
      type: object
      properties:
        videoUrls:
          maxItems: 10
          description: 视频文件 URL 列表（最多 10 个，总大小限 200MB，总时长限 600 秒）
          example:
            - https://example.com/video.mp4
          type: array
          items:
            type: string
        description:
          type: string
          maxLength: 1000
          description: 音乐描述（最多 1000 字符）
          example: Upbeat background music for a travel vlog
        tags:
          maxItems: 10
          description: 风格标签（最多 10 个）
          example:
            - upbeat
            - cinematic
          type: array
          items:
            type: string
        outputFormat:
          enum:
            - mp3_22050_32
            - mp3_24000_48
            - mp3_44100_32
            - mp3_44100_64
            - mp3_44100_96
            - mp3_44100_128
            - mp3_44100_192
            - pcm_8000
            - pcm_16000
            - pcm_22050
            - pcm_24000
            - pcm_32000
            - pcm_44100
            - pcm_48000
            - ulaw_8000
            - alaw_8000
            - opus_48000_32
            - opus_48000_64
            - opus_48000_96
            - opus_48000_128
            - opus_48000_192
          type: string
          description: 输出格式，格式为 codec_sampleRate_bitrate
          default: mp3_44100_128
        signWithC2pa:
          type: boolean
          description: 是否使用 C2PA 签名标记 AI 生成内容。仅适用于 MP3 输出格式
          default: false
      required:
        - videoUrls
    TaskIdDto:
      type: object
      properties:
        taskId:
          type: string
          description: 任务 ID，用于后续查询结果
      required:
        - taskId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````