Saltar al contenido principal
POST
/
kling
/
v1
/
audio
/
text-to-audio
Create a Kling text-to-audio task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/audio/text-to-audio \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Soft ambient ocean waves at sunrise.",
  "duration": 5
}
'
{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "861254119619698760",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773367502225,
    "updated_at": 1773367502225
  }
}
Usa este endpoint para generar un clip de audio corto a partir de un prompt de texto mediante Kling.

Antes de llamarlo

  • Mantén prompt conciso y directo
  • Comienza con duration entre 3 y 10 segundos
  • Considera callback_url y external_task_id como ayudas de integración opcionales, no como requisitos principales

Flujo de la tarea

1

Enviar la tarea de audio

Envía el prompt de texto y la duración, luego guarda el id de tarea devuelto.
2

Consultar la tarea

Continúa con Consultas individuales usando la ruta de consulta de audio de Kling hasta que la tarea alcance un estado terminal.
3

Guardar la salida de audio

Persiste el recurso de audio final si lo necesitas más allá del periodo de entrega del proveedor.
La validación en vivo del 2026-03-13 confirmó que se aceptó una solicitud mínima con solo prompt y duration, y devolvió task_status: submitted.
Para consultar la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
prompt
string
predeterminado:Hello
requerido

Text prompt describing the audio to generate. Max 200 characters.

duration
integer
predeterminado:5
requerido

Duration of the generated audio in seconds. Range: 3.0–10.0, supports one decimal place.

external_task_id
string
predeterminado:audio-text-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
predeterminado:https://example.com/webhook

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

Respuesta

200 - application/json

Task accepted.

code
integer
requerido

Error code; specific error code definition

message
string
requerido

Error message

data
object
requerido