Ana içeriğe atla
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
  }
}
Bu endpoint’i kullanarak bir kaynak videodan ses çıktısı oluşturabilirsiniz.

Çağırmadan önce

  • video_id veya video_url gönderin, ancak ikisini birden göndermeyin
  • Kaynak klip başlangıçta Kling’den gelmediyse video_url kullanın
  • Entegrasyonunuz bunlara ihtiyaç duymuyorsa callback_url ve external_task_id alanlarını isteğe bağlı bırakın

Görev akışı

1

Kaynak videoyu gönderin

Kling video_id ya da erişilebilir bir video_url gönderin, ardından dönen görev kimliğini kaydedin.
2

Görevi sorgulayın

Görev son duruma ulaşana kadar Kling ses sorgu yolunu kullanarak Individual Queries ile devam edin.
3

Çıktıyı kalıcı olarak saklayın

Kararlı saklama veya sonraki işleme adımları için ihtiyaç duyuyorsanız nihai ses varlığını saklayın.
Tam parametre referansı için resmî Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json
video_id
string
varsayılan:861034216165875784
gerekli

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
varsayılan: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
varsayılan:https://example.com/webhook

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

video_url
string
varsayılan: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.

Yanıt

200 - application/json

Task accepted.

code
integer
gerekli

Error code; specific error code definition

message
string
gerekli

Error message

data
object
gerekli