render

Render a slide from a structured SSG intent (mirrors MCP create_slide)

Deterministic SSG render from a structured intent — the REST mirror of the MCP create_slide tool. Provide ONE of: form (+ typed content fields) for a typed intent, prior_id (+content) to render an exact catalog prior (no routing), author_ssg for a full AuthorSSG document, or a prose brief. $0.05 per slide.

preview:true → a FREE ephemeral PNG preview (no job, no charge, nothing downloadable). Eligible only for verbatim inputs (prior_id/author_ssg); briefs/images return 400 (use Generate).

Brief-mode style asks (dark/light, look adjectives) auto-map onto built-in themes unless theme_id is set — pick one explicitly via GET /v1/brands or browse_catalog(type=themes).

post/v1/render/intent

Request

  • Base URL: https://api.slideforge.dev
  • URL: https://api.slideforge.dev/v1/render/intent
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

briefstring nullable
formstring nullable
variantstring nullable
prior_idstring nullable
contentobject nullable
author_ssgobject nullable
headlinestring nullable
contextstring nullable
subjectstring nullable
takeawaystring nullable
cautionstring nullable
highlightstring nullable
source_notestring nullable
datestring nullable
notesstring nullable
form_descriptionstring nullable
densitystring nullable
direction'ltr' | 'rtl' nullable
metricobject nullable
dataobject nullable
image_srcstring nullable
image_promptstring nullable
auto_decomposeboolean nullable
namestring nullable
theme_idstring nullable
brandobject nullable
sourcestring nullable
previewboolean
detailstring nullable
allow_fabricationboolean
allow_low_confidenceboolean
allow_truncationboolean
dry_runboolean
quality_profilestring nullable
variant_policystring nullable
allow_variant_fallbackboolean
min_font_ptnumber nullable
imagerystring nullable
imagery_tagstring nullable
stylingstring nullable
verifystring nullable

Response

Render complete (or free PNG preview)

unknown required

Changes

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