Tugas
Pekerjaan yang berjalan lama — menulis satu buku penuh, narasi massal, ekspor buku audio — berjalan sebagai tugas latar belakang. Pantau endpoint ini, atau daftarkan webhook untuk job.succeeded / job.failed sebagai gantinya. Render PDF punya endpoint pemantauan sendiri (/books/{bookId}/production-jobs/{jobId}, lihat Produksi).
Tampilkan daftar tugas
Terbaru lebih dulu. Parameter kueri:
| Parameter | Tipe | Catatan |
|---|---|---|
status | all | active | finished | active = dalam antrean atau berjalan; finished = berhasil, gagal, atau dibatalkan. Bawaan all. |
bookId | uuid | Hanya tugas buku ini. |
limit | 1–50 | Bawaan 20. |
Kunci yang dibatasi ke buku tertentu hanya melihat tugas pada buku yang diizinkan; meminta buku lain mengembalikan daftar kosong, bukan 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 }
]
}Pantau satu tugas
Field yang sama dengan daftar, ditambah result (bergantung jenisnya, mis. { audiobookUrl, sizeBytes }). Id yang tidak dikenal — dan tugas pada buku yang tidak bisa dilihat kunci bercakupan — mengembalikan 404.
Batalkan proses pembuatan buku
Membatalkan alur kerja pembuatan satu buku penuh yang aktif, mengembalikan statusnya, dan mengembalikan kredit untuk bab yang belum ditulis. Idempoten: mengembalikan ok: true meski tidak ada yang sedang berjalan.
{ "data": { "ok": true, "cancelled": true, "refundedCredits": 14 } }