Generate quick NPC dialogue
Synchronous NPC dialogue generation for real-time use (e.g. Foundry VTT). Makes a single LLM call (economy tier, quick-dialogue pack) and returns within 1-3 seconds. No session creation or polling required. Requires a valid Bearer token.
The response includes the NPC’s spoken dialogue, their current mood, a stage_direction for the GM, and suggested_actions as follow-up hints.
Body
POST /v1/projects/{project_id}/quick-dialogue
Synchronous NPC dialogue generation - single LLM call, 1-3 sec response. Bypasses CoreRuntimeGraph; no session creation, no event sourcing.
Design reference: docs/discovery/foundry-vtt-module/4-decide/concepts-extracted.md
Display name of the NPC
1 - 100What the player just said or did.
1 - 500Free-text or structured description of the NPC (race, alignment, traits, biography). Accepts either a plain string or a JSON object from Actor Context Extraction.
GM-provided situational context (location, stakes, mood of scene).
500Desired emotional tone: neutral, friendly, hostile, cautious, suspicious, etc.
50Game system identifier (dnd5e, pf2e, generic).
20Maximum tokens for the LLM response (50-500).
50 <= x <= 500Response
NPC dialogue generated successfully
200 response for POST /v1/projects/{project_id}/quick-dialogue.
The NPC's spoken words (inline stage directions stripped out).
NPC's current emotional state, e.g. 'worried'.
Behavioral/visual description for the GM, e.g. 'leans in close, lowers voice'.
GM hints for follow-up player actions.