Texto a Audio

Usa la API de Kling Text to Audio en CometAPI para convertir prompts de texto en audio con controles de estilo de voz, opciones de duración y salida lista para Streaming.

POST /kling/v1/audio/text-to-audio

Create a Kling text-to-audio task

cURL

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
}
'

200

{
  "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 opcionales de integración, 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. Almacenar la salida de audio

   Persiste el recurso de audio final si lo necesitas más allá de la ventana de entrega del proveedor.

Para consultar la referencia completa de parámetros, revisa 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

Show child attributes