Passer au contenu principal
POST
/
kling
/
v1
/
audio
/
video-to-audio
Create a Kling video-to-audio task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/audio/video-to-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://xxxxx.mp4"
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
Utilisez ce point de terminaison 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 de Kling à l’origine
  • Laissez callback_url et external_task_id facultatifs, sauf si votre intégration en a besoin

​
Flux de la tâche

1

Soumettre la vidéo source

Envoyez soit le video_id Kling, soit une video_url accessible, puis enregistrez l’id de tâche renvoyé.
2

Interroger la tâche

Continuez avec Requêtes individuelles en utilisant le chemin de requête audio Kling jusqu’à ce que la tâche atteigne un état terminal.
3

Conserver la sortie

Stockez la ressource audio finale si vous avez besoin d’une conservation stable ou d’un traitement en aval.
Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json
​
video_id
string
défaut:861034216165875784
requis

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.

​
external_task_id
string
défaut:audio-video-task-001

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

​
callback_url
string
défaut:https://example.com/webhook

Webhook URL for task status notifications. The server sends a callback when the task status changes.

​
video_url
string
défaut:http://runwaycdn.rixapi.com/attachments/video/runway/20241015/82bc23c83b5c32e75059c8328df5cffb.mp4

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.

Réponse

200 - application/json

Task accepted.

​
code
integer
requis

Error code; specific error code definition

​
message
string
requis

Error message

​
data
object
requis