Pedoman penulis

Setiap buku memiliki serangkaian dokumen referensi — satu per kind — yang dibaca penulis bab sebagai kanon: characters, plot_outline, theme_outline, style_guide, style_references, worldbuilding, research_notes, glossary, synopsis, lore, setting_bible, dan era_research. Setiap penimpaan lebih dulu menyimpan snapshot isi sebelumnya, jadi tidak ada yang hilang. kind yang tidak dikenal menghasilkan 400.

Tampilkan daftar dokumen

GET/v1/books/{bookId}/documentscakupan: books:read

Mengembalikan dokumen yang tersimpan (kind, title, chars, updatedAt — tanpa isi) ditambah kinds, katalog lengkap dengan judul dan uraian singkat untuk masing-masing, agar Anda bisa menampilkan pemilih tanpa menuliskannya secara manual.

Baca satu dokumen

GET/v1/books/{bookId}/documents/{kind}cakupan: books:read

Mengembalikan { kind, title, content, attachments, updatedAt }, atau 404 jika belum ada yang disimpan untuk kind tersebut.

Tulis satu dokumen

PUT/v1/books/{bookId}/documents/{kind}cakupan: books:write

Membuat atau memperbarui dokumen. Body: content (Markdown, hingga 200.000 karakter) dan title opsional (bawaannya judul katalog untuk kind tersebut). Isi sebelumnya lebih dulu disimpan sebagai snapshot ke daftar revisi.

curl -X PUT "$ANTHRA_BASE/books/$BOOK/documents/style_guide" \
  -H "authorization: Bearer $ANTHRA_TOKEN" \
  -H "content-type: application/json" \
  -d '{ "content": "## POV\nClose third, past tense. Never head-hop." }'

Susun draf dokumen dengan AI

POST/v1/books/{bookId}/documents/{kind}/draftcakupan: generation:run

Menyusun draf dokumen dari premis, dokumen pedoman lain milik buku itu, dan bab-bab pertama yang sudah ditulis, lalu menyimpannya. Memotong satu kredit bantuan sebelum model berjalan; kredit dikembalikan jika terjadi kegagalan apa pun, termasuk kedua penolakan di bawah.

FieldTipeCatatan
hintstringArahan opsional untuk model (maks. 2.000 karakter).
forcebooleanWajib untuk menimpa dokumen yang sudah berisi (alias: confirm). Isi lama lebih dulu disimpan sebagai snapshot.

Respons: 200 dengan dokumen yang tersimpan (kind, title, content, chars); 409 confirmation_required dengan previousChars jika dokumen tidak kosong dan force tidak diisi; 400 dengan needsPremise: true jika buku belum punya premis; 402 jika kredit akun habis.

Tampilkan daftar revisi

GET/v1/books/{bookId}/documents/{kind}/revisionscakupan: books:read

Snapshot yang tersimpan, dari yang terbaru: id, reason (apa yang menimpanya), previousChars, previousAttachments, dan createdAt. Isinya tidak disertakan — pulihkan salah satunya untuk melihatnya.

Pulihkan revisi

POST/v1/books/{bookId}/documents/{kind}/revisions/{revisionId}/restorecakupan: books:write

Mengembalikan dokumen ke snapshot tersebut. Isi saat ini lebih dulu disimpan sebagai snapshot, jadi pemulihan pun bisa dibatalkan. Id revisi milik buku atau kind lain mengembalikan 404.