mcp

Generate Writer Scene Still

Generate one full-bleed 16:9 scene still via hosted DesignForYou or local Grok CLI.

post/api/mcp/generate_writer_scene_still

Request

  • Base URL: https://writer.swapp1990.org (the document declares no server; this is the origin it was published from)
  • URL: https://writer.swapp1990.org/api/mcp/generate_writer_scene_still
  • Auth: none declared

Request body

job_idstring required

The story job ID.

chapterinteger required

Chapter number containing the selected paragraph.

paragraph_indexinteger nullable

Optional 0-based paragraph index; required when persist=true.

revisioninteger nullable

Displayed chapter revision number, if available.

promptstring nullable

Optional final scene prompt. When supplied, this is authoritative and is sent without Writer planner rewriting or prompt merging.

character_namesstring[]

Optional cast names. When omitted, Writer resolves cast references automatically.

reference_urlsstring[]

Optional direct reference image URLs. Supplied references override automatic cast references.

reference_labelsstring[]

Optional labels aligned with reference_urls.

location_design_idstring nullable

Optional D4U location design id.

location_reference_idstring nullable

Optional saved Writer location reference id.

location_namestring nullable

Optional saved location name to resolve.

location_labelstring

Reference binding label for location_design_id.

quality'balanced' | 'quality'

MiniMax H3 quality profile. Defaults to quality.

execution'hosted' | 'grok_cli'

Image execution path. 'hosted' uses DesignForYou; 'grok_cli' uses the signed-in local Grok Build CLI.

modelstring nullable

Optional image model override. Hosted defaults to the MiniMax H3 model selected by quality; grok_cli defaults to grok-imagine-image-quality.

persistboolean

Attach the generated still to the selected paragraph only after successful generation.

waitboolean

Wait for the in-process asset job to finish before returning.

wait_timeout_secondsnumber

Maximum nonblocking wait for the in-process asset job.

Response

Successful Response

story_urlstring nullable
article_urlstring nullable
job_idstring nullable
statusstring nullable
is_terminalboolean nullable

Changes

No recorded changes to this operation across all 1 revision of this API.