Generate NPC dialogue
Start async dialogue-graph generation for the NPC via CoreRuntimeGraph. Returns a session_id immediately (HTTP 202). Poll GET /v1/sessions/{session_id}/status for completion. Requires the runtime_generation feature flag to be enabled for the tenant.
Path Parameters
Body
POST /v1/projects/{project_id}/characters/{character_id}/generate
Generation mode: 'standard' (full pipeline) or 'fast' (skip evaluate node)
^(standard|fast)$Optional scene identifier. When provided, SceneContextLoader assembles the full scene context (location, actors, relationships, recent events) from the KG and injects it into pending_observation.
Optional token budget cap for scene context injection. Defaults to the pack configuration value when not specified.
x >= 100When True, the loaded SceneContext snapshot is included in the generation response for debugging purposes.
When true, synthesize an audio version of the generated dialogue via the configured TTS pipeline. Silently degrades to text-only when speech synthesis is unavailable. When successful, the response includes audio_url pointing to an MP3 served from the same project.
TTS voice gender hint when voice=true.
^(female|male)$Response
Generation accepted - poll session status
The response is of type Response Generate Dialogue V1 Projects Project Id Game Narrative Characters Character Id Generate Post · object.