Texte vers audio

Utilisez l’API Kling Text to Audio dans CometAPI pour convertir des prompts textuels en audio avec des contrôles de style vocal, des options de durée et une sortie prête pour le 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
  }
}

Utilisez cet endpoint pour générer un court clip audio à partir d’un prompt textuel via Kling.

​

Avant de l’appeler

• Gardez prompt concis et direct
• Commencez avec une duration comprise entre 3 et 10 secondes
• Considérez callback_url et external_task_id comme des aides d’intégration facultatives, et non comme des exigences essentielles

​

Flux de tâche

1. Soumettre la tâche audio

   Envoyez le prompt textuel et la durée, puis enregistrez l’id de tâche renvoyé.

2. Interroger la tâche

   Poursuivez avec Individual Queries en utilisant le chemin de requête audio Kling jusqu’à ce que la tâche atteigne un état terminal.

3. Stocker la sortie audio

   Conservez l’asset audio final si vous en avez besoin au-delà de la fenêtre de livraison du fournisseur.

Pour la référence complète des paramètres, consultez la documentation officielle de Kling.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

Corps

application/json

prompt · string · défaut: Hello · requis

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

duration · integer · défaut: 5 · requis

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

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

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

Réponse

200 - application/json

Task accepted.

code · integer · requis

Error code; specific error code definition

message · string · requis

Error message

data · object · requis

Show child attributes