mcp

Create Scene Still

Make one paragraph's scene still with your own image tools, then attach it.

Returns a brief built from the chapter: a 16:9 photographic prompt for the paragraph (with up to ~900 characters of lead-in), the cast in the shot with their attached reference images for identity (in the order to pass them), the story's fixed still style, acceptance checks, generator settings (local Codex CLI first, fal gpt-image-2.5 flare as backup) and a 60-minute upload URL. Cast without a reference image are listed in missing_references: call create_character_reference for them first for consistent faces. Generate locally, check against brief.checks, then PUT the file to upload.url (curl given; add ?model=<label>&caption=<short caption>). The still replaces any earlier still on that paragraph and revision. No server image generation.

post/api/mcp/create_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/create_scene_still
  • Auth: none declared

Request body

job_idstring required

The story job ID.

chapterinteger required

Chapter number that owns the paragraph.

paragraph_indexinteger required

0-based paragraph index within the chapter text (blank-line separated).

revisioninteger nullable

Chapter revision whose text to illustrate; omit for the current text.

character_namesstring[] nullable

Cast in the shot (full or first names, max 3). Omit to use the cast members named in the paragraph.

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.