Travaux asynchrones

# tâches asynchrones

Utilisez les tâches asynchrones TTS pour le texte long, la génération par lots, les flux de travail de type webhook et les flux d'interface utilisateur où les utilisateurs peuvent quitter la page pendant que l'audio est encore en traitement.

Créer un emploi

POST /api/open/v1/speech/tts/jobs
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

Demande

{
  "text": "Hello from Kitta Audio.",
  "voiceId": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "modelId": "fishaudio-s2pro",
  "format": "mp3"
}

Conservez le hachage du texte, la voix demandée et l'ID de tâche renvoyé dans votre base de données. Si votre travailleur plante après sa création, l'interrogation par ID de tâche est plus sûre que la création d'un deuxième travail.

L'exemple utilise la voix de test du système public 00a1b221-6137-4b73-ad62-b0cbce134167. Remplacez-le par votre identifiant vocal préféré après avoir vérifié la connexion.

curl https://kittaai.com/api/open/v1/speech/tts/jobs \
  -H "Authorization: Bearer KITTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from Kitta Audio.","voiceId":"00a1b221-6137-4b73-ad62-b0cbce134167","modelId":"fishaudio-s2pro","format":"mp3"}'

Réponse

Le point de terminaison de création renvoie 202 Accepted avec un objet tâche. Les champs de tâches exacts peuvent évoluer, mais les clients doivent au moins stocker l'identifiant et le statut.

{
  "id": "task_123",
  "status": "queued"
}

Obtenir un emploi

GET /api/open/v1/speech/tts/jobs/{taskId}
Authorization: Bearer KITTA_API_KEY

Les tâches réussies incluent audioUrl lorsqu'une URL audio de courte durée peut être générée. Les tâches ayant échoué incluent un code ou un message d'erreur. Traitez queued et processing comme des états non terminaux et interrogez avec interruption.

Facturation et crédits

Les tâches asynchrones peuvent réserver ou consommer des crédits lors de la création ou de l'achèvement d'une tâche en fonction du modèle activé. Ne créez pas de tâches en double comme stratégie de nouvelle tentative, sauf si l'utilisateur a explicitement demandé une deuxième sortie. Stockez l'ID de la tâche et récupérez-le.

Pour un lot, limitez la simultanéité de votre côté et vérifiez Profil avant d'ajouter un grand nombre de tâches. Si une tâche échoue en raison de crédits insuffisants, suspendez le rest du lot jusqu'à ce que le propriétaire du compte résolve le solde.

Erreurs