Da testo ad audio

Usa l’API Kling Text to Audio in CometAPI per convertire prompt testuali in audio con controlli sullo stile della voce, opzioni di durata e output pronto per lo 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 questo endpoint per generare una breve clip audio da un prompt testuale tramite Kling.

​

Prima di chiamarlo

• Mantieni prompt conciso e diretto
• Inizia con duration tra 3 e 10 secondi
• Considera callback_url ed external_task_id come supporti di integrazione opzionali, non requisiti fondamentali

​

Flusso del task

1. Invia il task audio

   Invia il prompt testuale e la durata, quindi salva l’id del task restituito.

2. Interroga il task

   Continua con Query individuali usando il percorso di query audio di Kling finché il task non raggiunge uno stato terminale.

3. Archivia l'output audio

   Conserva l’asset audio finale se ti serve oltre la finestra di consegna del provider.

La validazione in tempo reale del 2026-03-13 ha confermato che una richiesta minima con solo prompt e duration è stata accettata e ha restituito task_status: submitted.

Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

prompt · string · predefinito: Hello · obbligatorio

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

duration · integer · predefinito: 5 · obbligatorio

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

external_task_id · string · predefinito: 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 · predefinito: https://example.com/webhook

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

Risposta

200 - application/json

Task accepted.

code · integer · obbligatorio

Error code; specific error code definition

message · string · obbligatorio

Error message

data · object · obbligatorio

Show child attributes