Generate Profile
POST /api/writing/worldspell/generate-profile
Induce a deterministic voice profile draft from prose samples.
Phase A6 of the M15 DE migration replaced the LLM analysis path
with :func:voice_profile_inducer.induce_voice_profile. The
response shape stays identical so the frontend dialog renders the
output unchanged.
Request Body required
Section titled “Request Body required ”Responses
Section titled “ Responses ”Successful Response
Deterministic draft voice profile for author review.
object
Voice profile for a character, faction, species, or document.
Defines intentional language deviations so WorldSpell can suppress grammar/spelling violations that are stylistic choices, not errors.
object
Words that are intentional (lil, ya, ain’t, finna)
Multi-word phrases that are intentional
LanguageTool rule IDs to suppress (e.g. DOUBLE_NEGATIVES)
Language register
Reference text showing how this voice sounds
Author notes about this voice
Summary of what the inducer found in the text
Number of passages analyzed
‘ok’ when LanguageTool ran and contributed grammar_exceptions; ‘unavailable’ when LanguageTool could not initialize (bundled runtime missing, JVM crash, etc.) and the profile was induced without grammar-rule coverage. UI should warn the author that the draft has reduced fidelity in the latter case.
Validation Error