Trabajos asíncronos

Utilice trabajos asíncronos TTS para textos largos, generación por lotes, flujos de trabajo estilo webhook y flujos de interfaz de usuario donde los usuarios pueden abandonar la página mientras el audio aún se está procesando.

Crear trabajo

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

Pedido

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

Conserve el hash de texto, la voz solicitada y la identificación de la tarea devuelta en su base de datos. Si su trabajador falla después de la creación, sondear por identificación de tarea es más seguro que crear un segundo trabajo.

El ejemplo utiliza la voz de prueba del sistema público 00a1b221-6137-4b73-ad62-b0cbce134167. Reemplácelo con su ID de voz preferido después de verificar la conexión.

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

Respuesta

El punto final de creación devuelve 202 Accepted con un objeto de tarea. Los campos exactos de la tarea pueden evolucionar, pero los clientes deben al menos almacenar la identificación y el estado.

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

conseguir trabajo

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

Las tareas exitosas incluyen audioUrl cuando se puede generar una URL de audio de corta duración. Las tareas fallidas incluyen un código o mensaje de error. Trate a queued y processing como estados no terminales y realice una encuesta con retroceso.

Facturación y créditos

Los trabajos asíncronos pueden reservar o consumir créditos durante la creación o finalización de tareas, según el modelo habilitado. No cree trabajos duplicados como estrategia de reintento a menos que el usuario solicite explícitamente un segundo resultado. Guarde la identificación de la tarea y recupérese de ella.

Para un lote, limite la concurrencia de su lado y verifique Perfil antes de agregar una gran cantidad de tareas. Si una tarea falla por créditos insuficientes, suspenda el rest del lote hasta que el propietario de la cuenta resuelva el saldo.

Errores