Tarefas
Trabalhos longos — escrever o livro inteiro, narração em lote, exportação de audiolivro — rodam como tarefa em segundo plano. Consulte estes endpoints ou, em vez disso, registre um webhook para job.succeeded / job.failed. Renderizações em PDF têm seu próprio endpoint de consulta (/books/{bookId}/production-jobs/{jobId}, veja Produção).
Listar tarefas
Mais recentes primeiro. Parâmetros de consulta:
| Parâmetro | Tipo | Observações |
|---|---|---|
status | all | active | finished | active = na fila ou em execução; finished = concluída, com falha ou cancelada. Padrão all. |
bookId | uuid | Somente as tarefas deste livro. |
limit | 1–50 | Padrão 20. |
Uma chave restrita a livros só vê tarefas dos livros permitidos; pedir outro livro retorna uma lista vazia em vez de 403.
{
"data": [
{ "id": "6c1e…", "kind": "narrateBook", "status": "running", "bookId": "8f1c…",
"progress": "Narrating chapter 4 of 12…", "startedAt": "2026-11-02T09:01:00.000Z",
"finishedAt": null, "error": null }
]
}Consultar uma tarefa
Os mesmos campos da lista, mais result (específico do tipo, por exemplo { audiobookUrl, sizeBytes }). Ids desconhecidos — e tarefas de livros que uma chave com escopo não pode ver — retornam 404.
Cancelar uma geração de livro
Cancela o fluxo ativo de geração do livro inteiro, reverte o status do livro e reembolsa os créditos dos capítulos que ainda não foram escritos. Idempotente: retorna ok: true mesmo quando nada estava rodando.
{ "data": { "ok": true, "cancelled": true, "refundedCredits": 14 } }