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

# Créer un audio à partir d’une vidéo Kling

> Convertissez des vidéos Kling en audio de haute qualité via le endpoint Video to Audio de CometAPI, avec un format de sortie, une durée et un contrôle par prompt configurables.

Utilisez ce endpoint pour générer un résultat audio à partir d’une vidéo source.

## Avant de l’appeler

* Envoyez soit `video_id`, soit `video_url`, mais pas les deux
* Utilisez `video_url` lorsque le clip source ne provient pas à l’origine de Kling
* Gardez `callback_url` et `external_task_id` facultatifs, sauf si votre intégration en a besoin

## Flux de la tâche

<Steps>
  <Step title="Soumettre la vidéo source">
    Envoyez soit le `video_id` Kling, soit un `video_url` accessible, puis enregistrez l’id de tâche renvoyé.
  </Step>

  <Step title="Interroger la tâche">
    Continuez avec [Obtenir une tâche Kling](./individual-queries) en utilisant le chemin de requête audio Kling jusqu’à ce que la tâche atteigne un état terminal.
  </Step>

  <Step title="Conserver la sortie">
    Stockez la ressource audio finale si vous avez besoin d’une conservation stable ou d’un traitement en aval.
  </Step>
</Steps>

<Tip>
  Pour la référence complète des paramètres, consultez la [documentation officielle de Kling](https://app.klingai.com/global/dev/document-api/apiReference/model/videoToAudio).
</Tip>


## OpenAPI

````yaml api/openapi/video/kling/post-video-to-audio.openapi.json POST /kling/v1/audio/video-to-audio
openapi: 3.1.0
info:
  title: Video to Audio API
  version: 1.0.0
  description: Create a Kling audio-generation task from a source video.
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/audio/video-to-audio:
    post:
      summary: Create a Kling video-to-audio task
      description: >-
        Submit either a Kling `video_id` or an accessible `video_url`, then poll
        the returned task id through the generic Kling query route.
      operationId: video_to_audio
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              oneOf:
                - required:
                    - video_id
                - required:
                    - video_url
              properties:
                external_task_id:
                  type: string
                  description: >-
                    Optional user-defined task ID for your own tracking. Does
                    not replace the system-generated task ID. Must be unique per
                    account.
                callback_url:
                  type: string
                  description: >-
                    Webhook URL for task status notifications. The server sends
                    a callback when the task status changes.
                video_id:
                  type: string
                  description: >-
                    ID of a Kling-generated video. Only videos created within
                    the last 30 days with a duration of 3–20 seconds are
                    supported. Mutually exclusive with `video_url` — exactly one
                    must be provided.
                video_url:
                  type: string
                  description: >-
                    Accessible URL of the source video. Accepted formats: MP4,
                    MOV. Max 100 MB, 720p or 1080p resolution, duration 3–20
                    seconds. Mutually exclusive with `video_id` — exactly one
                    must be provided.
              default:
                video_url: https://your-video-host/source.mp4
            examples:
              Default:
                summary: Default
                value:
                  video_url: https://xxxxx.mp4
      responses:
        '200':
          description: Task accepted.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - data
                properties:
                  code:
                    type: integer
                    description: |
                      Error code; specific error code definition
                  message:
                    type: string
                    description: |
                      Error message
                  data:
                    type: object
                    required:
                      - task_id
                      - task_status
                      - created_at
                      - updated_at
                    properties:
                      task_id:
                        type: string
                        description: |
                          Task ID, system-generated
                      task_status:
                        type: string
                        description: >
                          Task status, enum values: submitted, processing,
                          succeed, failed
                      created_at:
                        type: integer
                        description: |+
                          Task creation time, Unix timestamp, in ms

                      updated_at:
                        type: integer
                        description: |
                          Task update time, Unix timestamp, in ms
      x-codeSamples:
        - lang: Shell
          label: Default
          source: |
            curl https://api.cometapi.com/kling/v1/audio/video-to-audio \
              -H "Authorization: Bearer $COMETAPI_KEY" \
              -H "Content-Type: application/json" \
              -d '{
                  "video_url": "https://xxxxx.mp4"
                }'
        - lang: Python
          label: Default
          source: >
            import os

            import requests


            response = requests.post(
                "https://api.cometapi.com/kling/v1/audio/video-to-audio",
                headers={"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]},
                json={
                        "video_url": "https://xxxxx.mp4"
                },
            )


            result = response.json()

            print(result["code"], result.get("data", {}).get("task_id"))  # code
            0 means submitted; poll the matching query endpoint until
            task_status is succeed
        - lang: JavaScript
          label: Default
          source: >
            const response = await
            fetch("https://api.cometapi.com/kling/v1/audio/video-to-audio", {
                method: "POST",
                headers: {
                    Authorization: `Bearer ${process.env.COMETAPI_KEY}`,
                    "Content-Type": "application/json",
                },
                body: JSON.stringify({
                        "video_url": "https://xxxxx.mp4"
                    }),
            });


            const result = await response.json();

            console.log(result.code, result.data?.task_id); // code 0 means
            submitted; poll the matching query endpoint until task_status is
            succeed
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````