Vai al contenuto principale
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
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa questo endpoint per generare una breve clip audio da un prompt di testo 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 strumenti di integrazione opzionali, non requisiti fondamentali

Flusso dell’attività

1

Invia l'attività audio

Invia il prompt di testo e la durata, quindi salva l’id dell’attività restituito.
2

Interroga l'attività

Prosegui con Query individuali usando il percorso di query audio di Kling finché l’attività non raggiunge uno stato terminale.
3

Archivia l'output audio

Conserva la risorsa audio finale se ti serve oltre la finestra di disponibilità del provider.
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