Skip to content
MZBase MZBase Docs

AI caption

  • Type ai.caption
  • Group AI
  • Role action
  • Risk acts outside MZBase
  • Side effect safe to repeat
  • Runs once per item
  • Needs ai

Writes a post caption for each account with AI

Also available to AI agents and over MCP as a tool.

Uses the AI gateway; its cost shows in the run.

Parameters

Section titled “Parameters”

route

AI route · string · optional

The AI route that runs it (AI settings). Empty = the default route for this kind of task; the route sets the price.

topic

Topic · string · required

What the post is about.

context

Context · string · optional

tone

Tone · string · optional · default casual · one of casual, friendly, professional, funny, sales

language

Language · string · optional

maxLength

Max length · integer · optional · default 300 · range 10 – 5000

hashtags

Hashtags · integer · optional · default 3 · range 0 – 30

emitSpintax

Write spintax · boolean · optional · default false

Return spintax {a|b} so each account posts a different variant.

seed

Randomness · object · optional · default {"mode":"random"}

Random choices repeat for the same seed: the same account gets the same variant every run. Empty = new each run.

Fields:

  • mode (string) Mode
  • value (integer) Value

into

Into field · string · optional · default caption

Outputs

Section titled “Outputs”
  • main

← All nodes