Screenplay, film and story toolkit over MCP: PDF formatting, stats, diagnosis, video prompts.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional license key for paid credits, value 'Bearer NRC-XXXX-XXXX-XXXX-XXXX'. The free daily tier works without it.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
CHARGED (1 credit per story project per 24h; any validation failure is never charged, absorbed-window repeats are free no-ops). Merge YOUR extraction of a prepared window: selectors must quote/anchor exact unit text (server pulls canon verbatim; client canon_text is rejected) and the returned canon_patch must be tail-hash-verified by the client before applying. YOU decide what the story means; the server only verifies anchors and patch safety, not truth. 失败不收费、同项目 24h 只扣一次；AI 提炼、服务端核验锚点与补丁安全，不判断真伪。
Idempotency key (optional; same request_id never double-charges)
License key NRC-XXXX-XXXX-XXXX-XXXX (optional — one free analysis per day works without one)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
CHARGED (1 credit per story project per 24h; any validation failure is never charged, absorbed-window repeats are free no-ops). Merge YOUR extraction of a prepared window: selectors must quote/anchor exact unit text (server pulls canon verbatim; client canon_text is rejected) and the returned canon_patch must be tail-hash-verified by the client before applying. YOU decide what the story means; the server only verifies anchors and patch safety, not truth. 失败不收费、同项目 24h 只扣一次；AI 提炼、服务端核验锚点与补丁安全，不判断真伪。
| Argument | Type | Description |
|---|---|---|
| state | object | |
| units* | array | |
| extraction* | object | |
| request_id | string | Idempotency key (optional; same request_id never double-charges) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — one free analysis per day works without one) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"units",
"extraction"
],
"properties": {
"state": {
"type": "object",
"required": [
"schema_version",
"project_token",
"canon_tail",
"bible",
"archive",
"absorbed_window_fps"
],
"properties": {
"bible": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 2000
},
"archive": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry",
"reason"
],
"properties": {
"entry": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"reason": {
"enum": [
"superseded",
"archived"
],
"type": "string"
},
"source": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"replacement_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 4000
},
"canon_tail": {
"type": "string",
"maxLength": 16000
},
"project_token": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"schema_version": {
"type": "string",
"const": "v1"
},
"absorbed_window_fps": {
"type": "array",
"items": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
},
"maxItems": 1024
}
},
"additionalProperties": false
},
"units": {
"type": "array",
"items": {
"type": "object",
"required": [
"unit_id",
"turn_id",
"role",
"text",
"start",
"end"
],
"properties": {
"end": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"role": {
"enum": [
"user",
"assistant"
],
"type": "string"
},
"text": {
"type": "string"
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"turn_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 4000,
"minItems": 1
},
"extraction": {
"type": "object",
"required": [
"base_state_hash",
"window_fp",
"canon_segments",
"bible_ops",
"story_merge"
],
"properties": {
"bible_ops": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"op",
"entry"
],
"properties": {
"op": {
"type": "string",
"const": "upsert"
},
"entry": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"target_id",
"entry"
],
"properties": {
"op": {
"type": "string",
"const": "supersede"
},
"entry": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"target_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"target_id",
"source"
],
"properties": {
"op": {
"type": "string",
"const": "archive"
},
"source": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"target_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"op",
"target_id"
],
"properties": {
"op": {
"type": "string",
"const": "no_change"
},
"target_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"maxItems": 2000
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
},
"story_merge": {
"anyOf": [
{
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"enum": [
"append",
"discard",
"no_story_change"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"action",
"anchor"
],
"properties": {
"action": {
"type": "string",
"const": "replace_tail"
},
"anchor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"canon_segments": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"unit_id",
"start_anchor",
"end_anchor"
],
"properties": {
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"end_anchor": {
"type": "string",
"minLength": 1
},
"start_anchor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
]
},
"maxItems": 4000
},
"base_state_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional; same request_id never double-charges)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — one free analysis per day works without one)"
}
},
"additionalProperties": false
}Deterministic screenplay statistics from the Narracore analyzer (analyzer_version 1.0, same rules as narracore.cn): a scene list with structured scene headings (scene number / location / time of day / INT-EXT parsed from each heading), per-scene word count, dialogue ratio and action density, a character table (cue count, scenes present, dialogue lines, dialogue chars, share of dialogue), and totals.genko_yoshi manuscript-sheet counts for Japanese competitions (400-character 20×20, 200-character 20×10, Kido-style 20×40 — always confirm the current rules of the competition you are entering). Accepts the same inputs as format_screenplay (input_format="text" or "blocks") — pass the SAME screenplay to both tools: one credit covers one screenplay for 24 hours across the screenplay tools (format / analyze / diagnose / convert / video prompts). When chaining tools, pass back the blocks you received (structured), not the formatted plain text. Failed calls are never charged; retrying the same request_id never double-charges. 剧本确定性统计：场景清单（结构化场景头）、逐场字数/对白占比/动作密度、角色戏份表、日式稿纸枚数三口径；同一份剧本 24 小时内多工具只扣一次。
| Argument | Type | Description |
|---|---|---|
| text | string | Raw screenplay text (required when input_format="text") |
| blocks | array | Typed blocks (required when input_format="blocks") |
| request_id | string | Idempotency key (optional) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| input_format | string | text (default): line-based screenplay text. blocks: typed blocks (e.g. the blocks returned by format_screenplay). |
Turn a screenplay into structured video-generation prompt scaffolds (deterministic — no LLM on the server; YOU fill the creative fields). For each selected scene it estimates ~15s segments (marked estimated), registers entities (characters + dialogue counts), proposes ≤4 shots per segment at beat boundaries, pre-fills dialogue lines VERBATIM from the screenplay (never rewrite them), and emits a two-layer template per segment: a SHARED block (A/V limits, camera base, style, entities, causal chain, global guards) written once, plus SHOT blocks carrying only private fields, with CUT-OUT/CUT-IN handoff lines between shots. STYLE GUIDANCE, never a style lock: by default the style section is a decision checklist (medium / frame-rate mechanism / brush / color-domain boundaries / light & face readability / banned vocabulary, each with how-to and example); optionally pass style="engine_cinematic" | "painted_on_twos" | "live_action_neutral" as an EDITABLE starting point, and/or style_note (≤500 chars, passed through verbatim). The response includes a condensed filling guide (eyeline = screen vector, performance arc, causal chain, motion domains, cut-point two-state, targeted negative guards). Estimates are proposals — adjust to the scene's beats. Charged like the other screenplay tools: one credit covers one screenplay for 24 hours across the screenplay tools; failed calls are never charged; same request_id retries never double-charge. After filling, call check_video_prompts (free) for drift findings. 剧本→视频提示词骨架：台词逐字预填、实体登记、段-镜两层结构与切点两态；风格由用户决定（决策清单+可选预设+自由附注），服务端不代做创意决定。
| Argument | Type | Description |
|---|---|---|
| text | string | Raw screenplay text (required when input_format="text") |
| style | string | Optional style preset as an EDITABLE starting point: engine_cinematic / painted_on_twos / live_action_neutral (default: decision checklist — never a lock) |
| blocks | array | Typed blocks (required when input_format="blocks") |
Check the remaining credits for a Narracore license key (NRC-XXXX-XXXX-XXXX-XXXX), plus recent usage and the purchase link. One credit covers one screenplay for 24 hours across the screenplay tools, or one film analysis, or one story project for 24 hours. Costs nothing. 查询授权码剩余服务次数（1 次＝一份剧本 24 小时剧本类工具通用，或一次拉片分析，或一个故事项目 24 小时）。 Preferred: set the key in your MCP client auth (Authorization: Bearer NRC-…) instead of passing it in chat.
| Argument | Type | Description |
|---|---|---|
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional if configured in client auth header) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional if configured in client auth header)"
}
}
}FREE deterministic quality gates for video-generation prompts written against a screenplay (no LLM on the server — pattern matching and set comparison only; findings are reported, nothing is blocked). Submit the SAME screenplay plus up to 10 finished prompt texts (≤20k chars each). VIOLATIONS (objective locks): DIALOGUE_DRIFT — a DIALOGUE line attributed to a registered screenplay character whose text is not found verbatim (whitespace/punctuation-insensitive), i.e. rewritten, trimmed or hallucinated dialogue; STRUCTURE_MISSING_CUTOUT / _CUTIN / HANDOFF_MISMATCH — scaffold-format prompts ([SHOT n] markers) must carry CUT-OUT last-frame and CUT-IN first-frame states with the next shot repeating the previous verbatim; STRUCTURE_DUPLICATES_SHARED — a SHARED line restated inside a shot block (shot blocks carry only private fields). ADVISORIES (disable with advisories=false): BARE_EYELINE ("looks at X" with no screen-space direction), LITERARY_RHETORIC (metaphors a renderer cannot draw), EMPTY_NEGATIVE ("no weirdness"-style), CONFLICT_PAIRS (locked vs handheld, single-shot vs hard cuts, on-twos vs smooth), PLACEHOLDER_LEFT, CHAR_LIMIT (yours, or the style preset's recommended one), STYLE_CONSISTENCY (banned vocabulary of your chosen preset, or two medium families mixed). Free-form prompts without [SHOT] markers skip structure gates (reported honestly). Free — no key needed, works without one. 免费确定性质量门：台词逐字锁、结构切点两态锁（violation）+ 视线/修辞/冲突/风格自洽启发（advisory），只报告不拦截。
| Argument | Type | Description |
|---|---|---|
| text | string | The screenplay the prompts were written from (required when input_format="text") |
| style | string | The style preset you built with (enables its banned-vocabulary and recommended-limit advisories) |
| blocks | array | Typed blocks (the screenplay the prompts were written from) |
CHARGED (1 credit per film analysis — the same analysis_id within 24h is NOT charged again; failed validation is never charged). Compile a validated film breakdown into a bounded, derivable result: authoritative validation → window→canonical shot merge (long-take windows are recombined so a 60s take is ONE shot in every statistic) → exact aggregates (distributions, shot lengths, per-scene aggregates, coverage) → deterministic-heuristic reconstructions (performance arc, cut logic, camera-performance logic — reproducible interpretations, explicitly labelled, NOT facts) → a print-ready PDF report (scene table + per-scene arcs + shot tables) with a 24h signed link. Your input records are NEVER echoed back — you already have them locally; this returns only the derived increments. analysis_id = sha256(media_id + sha256(topology_hash + film_schema_version + film_vocab_version)) with media_id = sha256(video bytes) computed locally; the server never sees the video and cannot verify media_id (it exists to protect YOU from double-charging, not as anti-cheat). Recompile after re-observing with a different model: same analysis_id, no re-charge; change the cuts or the protocol: new analysis. 收费编译：权威校验→长镜窗口合并→确定性统计+启发式重组→PDF 报告；不完整窗口/非法词表一律拒绝且不收费；同一分析任务 24h 内重复编译不重复扣费。
| Argument | Type | Description |
|---|---|---|
| shots* | array | |
| detail | string | Receipt detail (default full): summary omits per-scene aggregates and heuristic derivations — totals, identifiers and the PDF report link stay; free to re-call full within the same analysis_id 24h window |
| scenes* | array | |
| relations* | array | |
Convert between Narracore screenplay blocks and Fountain (the plain-text screenplay interchange format). direction="to_fountain": screenplay (input_format="text" or "blocks") → Fountain text (Latin content upper-cased per convention, CJK preserved verbatim; notes as [[…]]). direction="from_fountain": Fountain text → typed blocks you can pass straight to format_screenplay (input_format="blocks") — supports scene headings (INT/EXT/EST/I/E), character cues with (V.O.)-style extensions (extension becomes the delivery hint), parentheticals, dialogue, TO: transitions, > forced transitions, . forced action, [[notes]]; boneyard /*…*/ is stripped and reported, title-page keys and # section headers are skipped with warnings; mostly-Chinese content falls back to the Chinese screenplay parser (Fountain rules target Latin scripts). One credit covers one screenplay for 24 hours across the screenplay tools — converting and then formatting the same screenplay charges once. Failed calls are never charged. 剧本块与 Fountain 格式互转；同一份剧本 24 小时内多工具只扣一次。
| Argument | Type | Description |
|---|---|---|
| text | string | to_fountain only: raw screenplay text (input_format="text") |
| blocks | array | to_fountain only: typed blocks (input_format="blocks") |
| fountain | string | from_fountain only: the Fountain source text |
| direction | string | Required, one of to_fountain | from_fountain: to_fountain = screenplay → Fountain text; from_fountain = Fountain text → typed blocks. |
| request_id | string | Idempotency key (optional) |
| license_key |
Scene-level "shootability" diagnosis for a screenplay, using the same ai-2.0 rules as narracore.cn: YOU (the calling AI) cite the evidence, the server validates it and computes the score — no LLM on the server. Two steps: (1) mode="material" (FREE) returns each scene as a numbered block list ([n] [type] text), the strict findings JSON schema, and 6 problem types (abstract_psychology, literary_summary, unfilmable_information, unclear_space, weak_visible_action, unplayable_direction); (2) after analyzing the material yourself, call mode="score" with findings=[{scene, summary, problems:[{type, severity(low|medium|high), evidence (verbatim quote from the material), blocks (ordinals), suggestion}]}]. The server maps ordinals to blocks, drops any finding whose evidence cannot be verified (that scene then scores null — never faked), and computes each scene's 0-100 score (severity-weighted evidence coverage, exact arithmetic) plus a reference-only structural baseline. One credit covers one screenplay for 24 hours across the screenplay tools. Failed calls are never charged. 剧本逐场影视化度诊断：AI 举证、程序算分（0-100，证据核验，无效即空不冒充）。
| Argument | Type | Description |
|---|---|---|
| mode | string | Required, one of material | score: material (free) returns the numbered scene material + schema; score submits findings for validation and scoring. |
| text | string | |
| blocks | array | |
| scenes | array | material mode only: scene numbers (1-based) to render; default all |
| findings | array | score mode only: your per-scene findings |
| request_id |
Convert raw or loosely formatted screenplay text (Chinese, English, or mixed — including Japanese broadcast-drama format and Chinese colon-style dialogue scripts) into professionally structured screenplay blocks and a print-ready PDF on a fixed typewriter character grid identical to narracore.cn. Use it for screenplay formatting, import, or producing a shareable screenplay PDF — NOT for general prose rewriting or story editing. INPUT (contract_version 3) — two modes: • input_format="text" (default): line-based screenplay text, one element per line — scene headings ("INT. LAB - DAY", "第 N 场 …"), CHARACTER names in CAPS or CJK on their own line, short dialogue lines after them, standalone (…) parentheticals, standalone transitions ("CUT TO:", "切至：…"). Inline dialogue 名前「セリフ」 and 人名：台词 is parsed natively. An unbroken wall of text renders as continuous action and is flagged UNRESOLVED_STRUCTURE. • input_format="blocks": typed blocks validated and rendered EXACTLY as submitted, never re-classified; ids echoed. CHAINING: to run other tools on this screenplay, pass back the BLOCKS you received — not the plain text (it parses differently). The same screenplay is charged once per 24h across analyze/diagnose/convert/video-prompt tools; check_video_prompts is free. • output="validate_only": structure check + diagnostics only, free. Before delivering: read diagnostics[] (code/severity/line or block_id/message/suggested_action) with the user; confidence = share of non-ambiguous lines, NOT accuracy. Billing: one credit = one screenplay for 24h across the screenplay tools (or one film analysis / one story project). Free tier: one credit per day per visitor, no key. Failed calls are never charged; the same request_id never double-charges. On free_tier_exhausted or quota_exhausted: relay the price and purchase link from the response verbatim; never invent a license key. Competition submissions: style="uk"/"fr" (A4, BBC/French layout), dialogue_breaks=true ((MORE)/(CONT'D) on page breaks), cover.anonymous=true (no author on title page) — rendering options, free within the 24h bundle. Full parameter manual (cover/header/footer/style, examples): https://narracore.app/llms.txt
| Argument | Type | Description |
|---|---|---|
| text | string |
FREE. Return the Narracore Film Contract by section — the protocol that lets ANY vision-capable agent turn its own observation of a film into a stable, comparable, traceable Film IR (shot/scene/relation), validated and compiled by this server. The video NEVER leaves your machine: you observe and reason with your own models, this server provides the shared language and the deterministic toolchain. section="core" (default): pipeline, entities, the window protocol for long takes, observability levels (observed/mixed/inferred), entity-level provenance, limits. "vocabulary": the closed vocabularies + alias table (normalization is exact→alias→reject — no fuzzy guessing). "observation_guidance": the observation prompt template + how to write interpretive fields. "reasoning_guidance": the dramatic-layer/scene/relation prompt + the Q&A playbook for answering questions from the compiled result. "media_recipe": reference ffmpeg recipes (a platform adapter example — not authoritative output). "all": every section in one call — recommended on first contact. 免费下发的影视拉片契约：分类词表、观察/推理提示词、窗口协议、问答 playbook 与备料配方示例（section="all" 一次拿全）。
| Argument | Type | Description |
|---|---|---|
| section | string | Contract section to return (default: core; "all" returns every section in one call) |
| film_schema_version | string | Request a specific film schema version (default: current) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"section": {
"enum": [
"core",
"vocabulary",
"observation_guidance",
"reasoning_guidance",
"media_recipe",
"all"
],
"type": "string",
"description": "Contract section to return (default: core; \"all\" returns every section in one call)"
},
"film_schema_version": {
"type": "string",
"maxLength": 16,
"description": "Request a specific film schema version (default: current)"
}
}
}FREE deterministic. Turn shot-cut timestamps into the analysis topology every Film Protocol agent shares: numbered base shots (shot-000001), long-take windowing (shot-000017-w01of03 when a shot exceeds the profile cap), and greedy analysis units (≤20s / ≤8 shots per unit by default). Pass duration_sec + the cut timestamps you detected locally (e.g. ffmpeg scene filter, threshold 0.30 — see get_film_contract section="media_recipe"); you get back windows and units carrying both source-relative and clip-relative times to cut your analysis clips and label your observations with. No ffmpeg commands are returned (execution is your platform's business). 免费：切镜时间点 → 统一分析拓扑（长镜开窗 + ≤20s/≤8 镜单元）。
| Argument | Type | Description |
|---|---|---|
| duration_sec* | number | Total duration of the film/video in seconds |
| cut_timestamps* | array | Shot-cut timestamps in seconds (ascending; 0 and duration are implied) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"duration_sec",
"cut_timestamps"
],
"properties": {
"duration_sec": {
"type": "number",
"description": "Total duration of the film/video in seconds",
"exclusiveMinimum": 0
},
"cut_timestamps": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4000,
"description": "Shot-cut timestamps in seconds (ascending; 0 and duration are implied)"
}
}
}FREE. Split a story conversation (verbatim user/assistant turns) into stable, hash-anchored units for the Narracore Story Continuity Protocol. YOU judge the story; the server only slices and anchors provenance — a source is traceable, not proof your interpretation is true. Keep the full text and returned StoryState client-side (server stores nothing); failed calls are never charged. 免费：故事窗口确定性切分与锚定；AI 判断、服务端只核验出处，出处不证明结论真伪；全文与 state 由调用方保存，失败不收费。
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| state | object | |
| request_id | string | Idempotency key (optional; same request_id never double-charges) |
| conversation* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"conversation"
],
"properties": {
"lang": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en"
},
"state": {
"type": "object",
"required": [
"schema_version",
"project_token",
"canon_tail",
"bible",
"archive",
"absorbed_window_fps"
],
"properties": {
"bible": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 2000
},
"archive": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry",
"reason"
],
"properties": {
"entry": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"reason": {
"enum": [
"superseded",
"archived"
],
"type": "string"
},
"source": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"replacement_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 4000
},
"canon_tail": {
"type": "string",
"maxLength": 16000
},
"project_token": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"schema_version": {
"type": "string",
"const": "v1"
},
"absorbed_window_fps": {
"type": "array",
"items": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
},
"maxItems": 1024
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional; same request_id never double-charges)"
},
"conversation": {
"type": "array",
"items": {
"type": "object",
"required": [
"role",
"text"
],
"properties": {
"role": {
"enum": [
"user",
"assistant"
],
"type": "string"
},
"text": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 4000,
"minItems": 1
}
},
"additionalProperties": false
}Bilingual side-by-side screenplay PDF: submit the ORIGINAL screenplay (same inputs as format_screenplay) plus "translation" — the translated screenplay text you or your AI prepared. Both versions are typeset on the same fixed typewriter grids (Chinese 33×38 / English 61×55) side by side on A3 landscape pages, aligned scene by scene (each scene starts on a fresh page with both versions at the top). The two sides MUST have the SAME number of scene headings — a mismatch returns a scene-by-scene comparison to fix first. The translation is user-provided; this tool typesets, it never translates. One credit = the original screenplay's 24h bundle (same as the other screenplay tools) — revising the translation and re-rendering the same original within 24h is free.
| Argument | Type | Description |
|---|---|---|
| text | string | Original screenplay text (required when input_format="text") |
| blocks | array | Typed blocks for the original screenplay (required when input_format="blocks") |
| request_id | string | Idempotency key (optional) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| translation* | string | Translated screenplay text (user-provided) — must contain the same number of scene headings as the original |
| input_format | string | text (default): line-based screenplay text; blocks: typed blocks |
FREE. Render a StoryState into a zh/en handoff document (recent-canon window + bible) for a successor writer/AI. The server formats the state you SUPPLY — project_token proves identity only, not that the state content is authentic or current. Keep the full text client-side; failed calls are never charged. 免费：把调用方提供的 StoryState 排成交接文档；token 仅证身份、不证明 state 内容真实或最新；失败不收费。
| Argument | Type | Description |
|---|---|---|
| lang | string | |
| state* | object | |
| direction | string | |
| request_id | string | Idempotency key (optional; same request_id never double-charges) |
| recent_chars | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"state"
],
"properties": {
"lang": {
"enum": [
"zh",
"en"
],
"type": "string",
"default": "en"
},
"state": {
"type": "object",
"required": [
"schema_version",
"project_token",
"canon_tail",
"bible",
"archive",
"absorbed_window_fps"
],
"properties": {
"bible": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 2000
},
"archive": {
"type": "array",
"items": {
"type": "object",
"required": [
"entry",
"reason"
],
"properties": {
"entry": {
"type": "object",
"required": [
"entry_id",
"kind",
"text",
"sources"
],
"properties": {
"kind": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"text": {
"type": "string",
"minLength": 1
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"entry_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"reason": {
"enum": [
"superseded",
"archived"
],
"type": "string"
},
"source": {
"type": "object",
"required": [
"window_fp",
"unit_id",
"quote"
],
"properties": {
"quote": {
"type": "string",
"minLength": 1
},
"unit_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"window_fp": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
}
},
"additionalProperties": false
},
"replacement_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 4000
},
"canon_tail": {
"type": "string",
"maxLength": 16000
},
"project_token": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"schema_version": {
"type": "string",
"const": "v1"
},
"absorbed_window_fps": {
"type": "array",
"items": {
"type": "string",
"pattern": "^sw-v1:[a-f0-9]{64}$"
},
"maxItems": 1024
}
},
"additionalProperties": false
},
"direction": {
"type": "string",
"maxLength": 8000
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional; same request_id never double-charges)"
},
"recent_chars": {
"type": "integer",
"default": 9000,
"maximum": 16000,
"minimum": 0
}
},
"additionalProperties": false
}FREE preflight for a film breakdown payload (film_manifest + shots + scenes + relations). Checks the contract WITHOUT watching anything: schema shape, closed vocabularies (exact→alias→reject), cross-references (shot ids, scene membership, relation endpoints), window topology (a long take's windows must be complete), provenance shape, and observability metadata only — it never judges whether an observation is TRUE (the server cannot see your video). Lossless representation fixes (alias/trim/wrap) are returned as normalized_patch; semantic problems are errors for YOU to fix, with retry_feedback to feed back to your model. This is advisory: compile_film_breakdown re-validates authoritatively. 免费预检：契约/词表/交叉引用/窗口拓扑校验，只修表示层、绝不代改语义；编译前先跑它可省一次失败往返。
| Argument | Type | Description |
|---|---|---|
| shots* | array | |
| scenes* | array | |
| relations* | array | |
| film_manifest* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"film_manifest",
"shots",
"scenes",
"relations"
],
"properties": {
"shots": {
"type": "array",
"items": {
"type": "object",
"required": [
"shot_id",
"start_sec",
"end_sec"
],
"properties": {
"tags": {},
"end_sec": {
"type": "number"
},
"shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"scene_key": {
"type": "string",
"maxLength": 64
},
"start_sec": {
"type": "number"
},
"scene_grammar": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"spatial_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"dramatic_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"temporal_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"objective_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"transfer_profile": {},
"audio_observation": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"entity_provenance": {
"type": "object",
"properties": {
"model": {
"type": "string",
"maxLength": 64
},
"run_id": {
"type": "string",
"maxLength": 64
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"source_stage": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"performance_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"prompt_reverse_fields": {},
"scene_boundary_before": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 2400,
"minItems": 1
},
"scenes": {
"type": "array",
"items": {
"type": "object",
"required": [
"scene_key"
],
"properties": {
"title": {
"type": "string",
"maxLength": 2000
},
"summary": {
"type": "string",
"maxLength": 2000
},
"scene_key": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"editing_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"director_intent": {
"type": "string",
"maxLength": 2000
},
"performance_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"entity_provenance": {
"type": "object",
"properties": {
"model": {
"type": "string",
"maxLength": 64
},
"run_id": {
"type": "string",
"maxLength": 64
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"source_stage": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"camera_performance_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"maxItems": 400
},
"relations": {
"type": "array",
"items": {
"type": "object",
"required": [
"from_shot_id",
"to_shot_id"
],
"properties": {
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"to_shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"from_shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"relation_type": {
"type": "string",
"maxLength": 32
}
},
"additionalProperties": false
},
"maxItems": 2400
},
"film_manifest": {
"type": "object",
"required": [
"media_id",
"duration_sec",
"cut_timestamps"
],
"properties": {
"media_id": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"duration_sec": {
"type": "number",
"maximum": 28800,
"exclusiveMinimum": 0
},
"cut_timestamps": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4000
}
},
"additionalProperties": false
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "Raw screenplay text (required when input_format=\"text\")"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "Typed blocks (required when input_format=\"blocks\")"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text. blocks: typed blocks (e.g. the blocks returned by format_screenplay)."
}
}
}| scenes | array | Scene numbers (1-based) to scaffold; default all (batch with this when a full screenplay is too large) |
| request_id | string | Idempotency key (optional) |
| style_note | string | Free-form style note (≤500 chars) passed through VERBATIM into every segment shared block — never validated |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| input_format | string | text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay). |
| segment_seconds | integer | Target segment duration in seconds (default 15, range 5-60) — estimates, adjust to actual beats |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "Raw screenplay text (required when input_format=\"text\")"
},
"style": {
"enum": [
"engine_cinematic",
"painted_on_twos",
"live_action_neutral"
],
"type": "string",
"description": "Optional style preset as an EDITABLE starting point: engine_cinematic / painted_on_twos / live_action_neutral (default: decision checklist — never a lock)"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "Typed blocks (required when input_format=\"blocks\")"
},
"scenes": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"maxItems": 200,
"description": "Scene numbers (1-based) to scaffold; default all (batch with this when a full screenplay is too large)"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"style_note": {
"type": "string",
"maxLength": 500,
"description": "Free-form style note (≤500 chars) passed through VERBATIM into every segment shared block — never validated"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay)."
},
"segment_seconds": {
"type": "integer",
"maximum": 60,
"minimum": 5,
"description": "Target segment duration in seconds (default 15, range 5-60) — estimates, adjust to actual beats"
}
}
}| prompts | array | The finished prompt(s), 1-10 items (from build_video_prompts scaffolds or free-form) |
| advisories | boolean | Run advisory gates too (default true; false = violations only) |
| char_limit | integer | Optional character limit per prompt (advisory; default: the style preset recommendation, or none) |
| request_id | string | Echoed back for tracing (this tool is free — no idempotency semantics needed) |
| input_format | string | text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "The screenplay the prompts were written from (required when input_format=\"text\")"
},
"style": {
"enum": [
"engine_cinematic",
"painted_on_twos",
"live_action_neutral"
],
"type": "string",
"description": "The style preset you built with (enables its banned-vocabulary and recommended-limit advisories)"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "Typed blocks (the screenplay the prompts were written from)"
},
"prompts": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "One finished prompt text to check"
},
"label": {
"type": "string",
"maxLength": 64,
"description": "Your name for this prompt (echoed in findings)"
}
}
},
"maxItems": 10,
"description": "The finished prompt(s), 1-10 items (from build_video_prompts scaffolds or free-form)"
},
"advisories": {
"type": "boolean",
"description": "Run advisory gates too (default true; false = violations only)"
},
"char_limit": {
"type": "integer",
"maximum": 100000,
"minimum": 100,
"description": "Optional character limit per prompt (advisory; default: the style preset recommendation, or none)"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Echoed back for tracing (this tool is free — no idempotency semantics needed)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay)."
}
}
}| request_id |
| string |
| Idempotency key (optional; same request_id never double-charges) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — one free analysis per day works without one) |
| film_manifest* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"film_manifest",
"shots",
"scenes",
"relations"
],
"properties": {
"shots": {
"type": "array",
"items": {
"type": "object",
"required": [
"shot_id",
"start_sec",
"end_sec"
],
"properties": {
"tags": {},
"end_sec": {
"type": "number"
},
"shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"scene_key": {
"type": "string",
"maxLength": 64
},
"start_sec": {
"type": "number"
},
"scene_grammar": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"spatial_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"dramatic_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"temporal_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"objective_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"transfer_profile": {},
"audio_observation": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"entity_provenance": {
"type": "object",
"properties": {
"model": {
"type": "string",
"maxLength": 64
},
"run_id": {
"type": "string",
"maxLength": 64
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"source_stage": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"performance_layer": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"prompt_reverse_fields": {},
"scene_boundary_before": {
"type": "boolean"
}
},
"additionalProperties": false
},
"maxItems": 2400,
"minItems": 1
},
"detail": {
"enum": [
"full",
"summary"
],
"type": "string",
"description": "Receipt detail (default full): summary omits per-scene aggregates and heuristic derivations — totals, identifiers and the PDF report link stay; free to re-call full within the same analysis_id 24h window"
},
"scenes": {
"type": "array",
"items": {
"type": "object",
"required": [
"scene_key"
],
"properties": {
"title": {
"type": "string",
"maxLength": 2000
},
"summary": {
"type": "string",
"maxLength": 2000
},
"scene_key": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"editing_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"director_intent": {
"type": "string",
"maxLength": 2000
},
"performance_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"entity_provenance": {
"type": "object",
"properties": {
"model": {
"type": "string",
"maxLength": 64
},
"run_id": {
"type": "string",
"maxLength": 64
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string"
},
"source_stage": {
"type": "string",
"maxLength": 64
}
},
"additionalProperties": false
},
"camera_performance_arc": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"maxItems": 400
},
"relations": {
"type": "array",
"items": {
"type": "object",
"required": [
"from_shot_id",
"to_shot_id"
],
"properties": {
"details": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"to_shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"from_shot_id": {
"type": "string",
"maxLength": 32,
"minLength": 1
},
"relation_type": {
"type": "string",
"maxLength": 32
}
},
"additionalProperties": false
},
"maxItems": 2400
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional; same request_id never double-charges)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — one free analysis per day works without one)"
},
"film_manifest": {
"type": "object",
"required": [
"media_id",
"duration_sec",
"cut_timestamps"
],
"properties": {
"media_id": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"duration_sec": {
"type": "number",
"maximum": 28800,
"exclusiveMinimum": 0
},
"cut_timestamps": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 4000
}
},
"additionalProperties": false
}
}
}| string |
| License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| input_format | string | to_fountain only: screenplay source format |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "to_fountain only: raw screenplay text (input_format=\"text\")"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "to_fountain only: typed blocks (input_format=\"blocks\")"
},
"fountain": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "from_fountain only: the Fountain source text"
},
"direction": {
"type": "string",
"description": "Required, one of to_fountain | from_fountain: to_fountain = screenplay → Fountain text; from_fountain = Fountain text → typed blocks."
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "to_fountain only: screenplay source format"
}
}
}| string |
| Idempotency key (optional) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| input_format | string | text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mode": {
"type": "string",
"description": "Required, one of material | score: material (free) returns the numbered scene material + schema; score submits findings for validation and scoring."
},
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000
},
"scenes": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
"maxItems": 200,
"description": "material mode only: scene numbers (1-based) to render; default all"
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"scene",
"summary",
"problems"
],
"properties": {
"scene": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Scene number as returned by mode=\"material\""
},
"summary": {
"type": "string",
"maxLength": 400,
"description": "Your 1-2 sentence summary of the scene"
},
"problems": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"severity",
"evidence"
],
"properties": {
"type": {
"enum": [
"abstract_psychology",
"literary_summary",
"unfilmable_information",
"unclear_space",
"weak_visible_action",
"unplayable_direction"
],
"type": "string",
"description": "One of the 6 problem types from mode=\"material\""
},
"blocks": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 8,
"description": "Block ordinals [n] the evidence came from"
},
"evidence": {
"type": "string",
"maxLength": 400,
"description": "Verbatim quote from the scene material"
},
"severity": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"description": "low | medium | high"
},
"suggestion": {
"type": "string",
"maxLength": 400
}
}
},
"maxItems": 20,
"description": "Problems you found, with verbatim evidence"
}
}
},
"maxItems": 200,
"description": "score mode only: your per-scene findings"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text. blocks: typed blocks (e.g. from format_screenplay)."
}
}
}| Raw screenplay text, one element per line (required when input_format="text") |
| cover | object | Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted; anonymous=true renders only title+date (competition blind-review convention — author/version stay off the page) |
| paper | string | Paper override for us/uk/fr: "letter" / "a4" / "a4_landscape" / "b4" (default follows style: us → letter, uk/fr → a4). Grid and page count are identical across papers. Vertical ja_* styles use a fixed sheet (omit) |
| style | string | Submission style: "us" (default — US Letter) / "uk" (A4, BBC-style margins, scene numbers on both sides) / "fr" (A4, French-style centered dialogue column) / vertical Japanese manuscript sheets "ja_business" (20×10, A4 landscape), "ja_standard" (20×20 400-character sheet, B4), "ja_kido" (20×40 Kido-style, A4 landscape) — pages = sheets. Rendering option — free to change within the same 24h screenplay bundle |
| blocks | array | Typed blocks (required when input_format="blocks") |
| footer | object | Explicit footer (centered below the text box); same value resolution as header |
| header | object | Explicit running header (overrides the default page-number line): field values come from cover; missing fields are skipped; page_number renders N/M at the right edge |
| output | string | pdf_and_blocks (default) / blocks_only / validate_only (free structure check, no render) |
| include | string | Receipt body shape (default both): blocks=typed blocks only, plain_text=formatted text only — halves the receipt for large screenplays; validate_only always echoes blocks |
| request_id | string | Idempotency key (optional) |
| license_key | string | License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one) |
| input_format | string | text (default): line-based screenplay text parsed server-side. blocks: submit typed blocks directly — validated and rendered as-is, never re-classified. |
| dialogue_breaks | boolean | US submission convention for dialogue spanning a page break: (MORE) at the bottom of the page and SPEAKER (CONT'D) at the top of the next. Default false |
| content_language | string | Content language (default: auto-detect) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "Raw screenplay text, one element per line (required when input_format=\"text\")"
},
"cover": {
"type": "object",
"properties": {
"date": {
"type": "string",
"maxLength": 64
},
"title": {
"type": "string",
"maxLength": 2000
},
"author": {
"type": "string",
"maxLength": 2000
},
"version": {
"type": "string",
"maxLength": 64
},
"anonymous": {
"type": "boolean"
}
},
"description": "Cover page fields — any field present adds a cover page (not counted in page numbers); date defaults to today (UTC) when omitted; anonymous=true renders only title+date (competition blind-review convention — author/version stay off the page)",
"additionalProperties": false
},
"paper": {
"type": "string",
"maxLength": 24,
"description": "Paper override for us/uk/fr: \"letter\" / \"a4\" / \"a4_landscape\" / \"b4\" (default follows style: us → letter, uk/fr → a4). Grid and page count are identical across papers. Vertical ja_* styles use a fixed sheet (omit)"
},
"style": {
"type": "string",
"maxLength": 24,
"description": "Submission style: \"us\" (default — US Letter) / \"uk\" (A4, BBC-style margins, scene numbers on both sides) / \"fr\" (A4, French-style centered dialogue column) / vertical Japanese manuscript sheets \"ja_business\" (20×10, A4 landscape), \"ja_standard\" (20×20 400-character sheet, B4), \"ja_kido\" (20×40 Kido-style, A4 landscape) — pages = sheets. Rendering option — free to change within the same 24h screenplay bundle"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64,
"description": "Your id for this block; echoed in output"
},
"text": {
"type": "string",
"maxLength": 200000,
"description": "Block text (scene_heading may omit it if location/time_of_day given)"
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64,
"description": "dialogue: speaker name; a character line is derived when rendering"
},
"delivery": {
"type": "string",
"maxLength": 120,
"description": "dialogue: delivery hint, rendered as a parenthetical before the line"
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "Typed blocks (required when input_format=\"blocks\")"
},
"footer": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"enum": [
"title",
"author",
"date",
"version",
"page_number"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1
}
},
"description": "Explicit footer (centered below the text box); same value resolution as header"
},
"header": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"enum": [
"title",
"author",
"date",
"version",
"page_number"
],
"type": "string"
},
"maxItems": 5,
"minItems": 1
}
},
"description": "Explicit running header (overrides the default page-number line): field values come from cover; missing fields are skipped; page_number renders N/M at the right edge"
},
"output": {
"enum": [
"pdf_and_blocks",
"blocks_only",
"validate_only"
],
"type": "string",
"description": "pdf_and_blocks (default) / blocks_only / validate_only (free structure check, no render)"
},
"include": {
"enum": [
"blocks",
"plain_text",
"both"
],
"type": "string",
"description": "Receipt body shape (default both): blocks=typed blocks only, plain_text=formatted text only — halves the receipt for large screenplays; validate_only always echoes blocks"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text parsed server-side. blocks: submit typed blocks directly — validated and rendered as-is, never re-classified."
},
"dialogue_breaks": {
"type": "boolean",
"description": "US submission convention for dialogue spanning a page break: (MORE) at the bottom of the page and SPEAKER (CONT'D) at the top of the next. Default false"
},
"content_language": {
"enum": [
"zh",
"en",
"auto"
],
"type": "string",
"description": "Content language (default: auto-detect)"
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"translation"
],
"properties": {
"text": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "Original screenplay text (required when input_format=\"text\")"
},
"blocks": {
"type": "array",
"items": {
"type": "object",
"required": [
"type"
],
"properties": {
"id": {
"type": "string",
"maxLength": 64
},
"text": {
"type": "string",
"maxLength": 200000
},
"type": {
"enum": [
"scene_heading",
"action",
"character",
"parenthetical",
"dialogue",
"transition",
"shot",
"note"
],
"type": "string"
},
"speaker": {
"type": "string",
"maxLength": 64
},
"delivery": {
"type": "string",
"maxLength": 120
},
"location": {
"type": "string",
"maxLength": 120
},
"time_of_day": {
"type": "string",
"maxLength": 16
},
"scene_number": {
"type": "string",
"maxLength": 16
}
}
},
"maxItems": 2000,
"description": "Typed blocks for the original screenplay (required when input_format=\"blocks\")"
},
"request_id": {
"type": "string",
"maxLength": 64,
"description": "Idempotency key (optional)"
},
"license_key": {
"type": "string",
"pattern": "^NRC-[A-Z2-9]{4}(-[A-Z2-9]{4}){3}$",
"description": "License key NRC-XXXX-XXXX-XXXX-XXXX (optional — free daily quota works without one)"
},
"translation": {
"type": "string",
"maxLength": 200000,
"minLength": 1,
"description": "Translated screenplay text (user-provided) — must contain the same number of scene headings as the original"
},
"input_format": {
"enum": [
"text",
"blocks"
],
"type": "string",
"description": "text (default): line-based screenplay text; blocks: typed blocks"
}
}
}