Spaces:
Sleeping
Sleeping
Commit History
-
Rewrite docs for terser, more austere style (no content changes)
255731f
-
Document the REST API and the security model
docs/api.md is the full reference for the job API, including the synthesis parameters that were previously only discoverable by reading the handler signature. Two things it makes explicit: - Cost control. A job with synthesize_audio=true costs one Gemini call plus one ElevenLabs call per non-mantra segment, which on a full teaching is real money. The documented workflow is synthesize_audio=false first, review the turn plan, then resubmit with turns_file to skip Gemini entirely. - The concurrency caveat, which has a security consequence and so appears in both docs: unlike TranslationUI and ArchiveAI-STT, this app's UI Generate handlers are NOT wrapped through the job-store semaphore. So active_jobs undercounts real work, and /api/drain does not stop a UI batch already running — "drained" is not a guarantee that nothing is writing. docs/security.md covers what's particular here: this is the one droplet app that writes to HuggingFace in normal operation, …b2d53f4