Posts

Generates branded social-media graphics — infographic posters, listicles, quote cards, stat tiles, and more.

POST/api/v1/postsIncluded · Developer plan

Omit format and the engine reads your prompt and auto-picks the best-fitting one from the list below; pass it to pin a specific format instead. Stateless — the response is not saved server-side; use /render (see Tools & batch) to re-theme/resize it later.

Parameters

Field	Type	Description & options
prompt	Required	The topic or text to generate a post about. Up to 4000 characters.
format	String	Pin a specific format instead of auto-selecting — see the list below. Discoverable programmatically via GET /api/schemas.
size	String	Canvas aspect ratio. `portraitlandscapesquarestory`
theme	String	Color mode. `light (default)dark`
style	String	Visual skin. `glass (default)flatblueprinteditorial`
layout	String	Optional list-layout hint for formats that support it (e.g. listicle/grid column count).
brand	Object	Per-request branding override — { name, handle, logo, colors: { primary, secondary } }. Doesn't touch your saved profile.
unbranded	Boolean	Set true to strip the brand mark (name/logo) for this render only — see Authentication & concepts.

Valid format values

posterlisticlequotechecklistannouncementcomparisonstatcodecampaignshowcasehiringeventofferadcoverroadmapresourcesgridtestimonial

Diagrams have their own dedicated create→refine→export flow — see Diagrams instead of pinning diagram here. Data charts and multi-slide carousels have their own endpoints too — see Tools & batch.

Not sure what a format looks like, or want its exact content shape? Call GET /api/schemas (see Tools & batch) for the machine-readable version.

See every format — Visit Gallery →

Code sample

# Auto-pick the best format from the prompt
curl -X POST https://api.capci.app/api/v1/posts \
  -H "x-api-key: capci_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Top 5 benefits of using AI agents",
    "size": "portrait",
    "theme": "dark"
  }'

# Or pin a specific format with "format"
curl -X POST https://api.capci.app/api/v1/posts \
  -H "x-api-key: capci_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Top 5 benefits of using AI agents",
    "format": "listicle",
    "size": "portrait",
    "theme": "dark"
  }'

# Generate without your saved brand mark, for a client/demo (unbranded: true)
curl -X POST https://api.capci.app/api/v1/posts \
  -H "x-api-key: capci_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Top 5 benefits of using AI agents",
    "unbranded": true
  }'