Influencer, Talking captions 1.0.0
| Template | Influencer, tpl_3245d6e9ee79 |
|---|---|
| Variant | Talking captions |
| Version | 1.0.0, the newest: what a channel following this variant draws |
| Shapes | 9x16, 4x5, 1x1, 16x9, 2x3 |
| Length | 16 seconds |
Example video
The 1x1 cut of this version, drawn from its own worked example. Open the video on its own.
What it accepts
Captions for a talking head: one to five sentences shown word by word, the word being said lifted out, over a picture of the speaker (or the brand's own film), with a title chip, the creator's tag and a call to action. The clip is as long as the sentences need. metaData is the post's title, descriptions and hashtags and is never drawn.
| Field | Type | Required | Limit | What it is |
|---|---|---|---|---|
clipData | group | yes | Clip data: Everything drawn in the clip: the title chip, what is said, the backdrop and the call to action. The creator's name and picture are the brand's badge, the handle is the channel's (else the brand's second title line). | |
clipData.kicker | text | up to 24 characters | Kicker: A short tag in the title chip, such as a series name or Part 2. | |
clipData.headline | text | up to 56 characters | Title chip: The hook, shown in a chip at the top for the whole clip. | |
clipData.sentences | list | yes | at least 1, up to 5 | What is said: One to five sentences, shown word by word with the word being said lifted out; the clip gets about three seconds longer for each. |
clipData.sentences[] | text | up to 84 characters | Sentence: One sentence as it is spoken. | |
clipData.picture | image | media:// file from the media library, alt text up to 120 characters | Picture: The speaker, as a still from the video or a portrait; any shape, the top of the picture is kept in view. Without one, the brand's own film or the creator's badge stands in. | |
clipData.cta | group | Call to action: The button at the end and the line under it, such as a web address, a handle or a phone number. | ||
clipData.cta.label | text | yes | up to 28 characters | Button: What the button says. |
clipData.cta.detail | text | up to 48 characters | Line under it: An address, a handle, a phone number. | |
clipData.disclaimer | text | up to 120 characters | Small print: A note that must be shown, such as Ad or Not medical advice. | |
clipData.look | group | Look: How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default. | ||
clipData.look.theme | enum | brand, light, dark, bold | Theme: Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page. | |
clipData.look.pace | enum | calm, standard, punchy | Pace: How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts. | |
clipData.look.corners | enum | square, soft, round | Corners: The shape of cards, pictures and buttons. | |
clipData.look.align | enum | start, centre | Text alignment: Where the text lines up. | |
clipData.look.layout | enum | overlay, split | Layout: Over the picture: the speaker fills the frame and the captions sit on it. Beside the picture: the speaker in a frame of their own, the captions on the page beside or under it. | |
clipData.look.captionStyle | enum | highlight, boxes, colour | Caption style: Highlight: the word being said on a pill of the brand colour. Boxes: every line on a card, the word in the brand colour. Colour: plain words, the one being said larger and in the brand colour. | |
clipData.look.paging | enum | words, sentence | Words at a time: A few words: two to five large words at a time, as in short videos. Whole sentence: the sentence stays, its words lighting up as they are said. | |
clipData.look.logo | enum | auto, free | Logo: The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose. | |
metaData | group | Meta data: Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data. | ||
metaData.title | text | up to 100 characters | Title: Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes. | |
metaData.captionTiny | text | up to 200 characters | Tiny description (Pinterest, Threads, X): Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionShort | text | up to 500 characters | Short description (Telegram, Threema, WeChat, WhatsApp): Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionMedium | text | up to 1500 characters | Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok): Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.captionLong | text | up to 4000 characters | Long description (Facebook Feed, YouTube): Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit. | |
metaData.hashtags | list | up to 15 | Hashtags: Written without the #. Up to 15, which every platform takes. | |
metaData.hashtags[] | text | up to 60 characters | Hashtag |
locales carries other languages: under each language code, the parts of clipData and metaData that differ, laid over the default, so a language with no copy still renders.
A picture is always a file from your media library: media:// followed by its id or its name.
Anything the table does not list is refused, and so is anything over its limit, with a 422 that
names the field.
The JSON Schema
{
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 24,
"title": "Kicker",
"description": "A short tag in the title chip, such as a series name or Part 2."
},
"headline": {
"type": "string",
"maxLength": 56,
"title": "Title chip",
"description": "The hook, shown in a chip at the top for the whole clip."
},
"sentences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 84,
"title": "Sentence",
"description": "One sentence as it is spoken."
},
"minItems": 1,
"maxItems": 5,
"title": "What is said",
"description": "One to five sentences, shown word by word with the word being said lifted out; the clip gets about three seconds longer for each."
},
"picture": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Picture",
"description": "The speaker, as a still from the video or a portrait; any shape, the top of the picture is kept in view. Without one, the brand's own film or the creator's badge stands in."
},
"cta": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Button",
"description": "What the button says."
},
"detail": {
"type": "string",
"maxLength": 48,
"title": "Line under it",
"description": "An address, a handle, a phone number."
}
},
"required": [
"label"
],
"additionalProperties": false,
"title": "Call to action",
"description": "The button at the end and the line under it, such as a web address, a handle or a phone number."
},
"disclaimer": {
"type": "string",
"maxLength": 120,
"title": "Small print",
"description": "A note that must be shown, such as Ad or Not medical advice."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"layout": {
"type": "string",
"enum": [
"overlay",
"split"
],
"title": "Layout",
"description": "Over the picture: the speaker fills the frame and the captions sit on it. Beside the picture: the speaker in a frame of their own, the captions on the page beside or under it.",
"enumNames": [
"Over the picture",
"Beside the picture"
]
},
"captionStyle": {
"type": "string",
"enum": [
"highlight",
"boxes",
"colour"
],
"title": "Caption style",
"description": "Highlight: the word being said on a pill of the brand colour. Boxes: every line on a card, the word in the brand colour. Colour: plain words, the one being said larger and in the brand colour.",
"enumNames": [
"Highlighted word",
"Text boxes",
"Coloured word"
]
},
"paging": {
"type": "string",
"enum": [
"words",
"sentence"
],
"title": "Words at a time",
"description": "A few words: two to five large words at a time, as in short videos. Whole sentence: the sentence stays, its words lighting up as they are said.",
"enumNames": [
"A few words",
"Whole sentence"
]
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"required": [
"sentences"
],
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: the title chip, what is said, the backdrop and the call to action. The creator's name and picture are the brand's badge, the handle is the channel's (else the brand's second title line)."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
},
"locales": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"clipData": {
"type": "object",
"properties": {
"kicker": {
"type": "string",
"maxLength": 24,
"title": "Kicker",
"description": "A short tag in the title chip, such as a series name or Part 2."
},
"headline": {
"type": "string",
"maxLength": 56,
"title": "Title chip",
"description": "The hook, shown in a chip at the top for the whole clip."
},
"sentences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 84,
"title": "Sentence",
"description": "One sentence as it is spoken."
},
"minItems": 1,
"maxItems": 5,
"title": "What is said",
"description": "One to five sentences, shown word by word with the word being said lifted out; the clip gets about three seconds longer for each."
},
"picture": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"pattern": "^media:\\/\\/[^\\s/\\\\\\u0000-\\u001f][^/\\\\\\u0000-\\u001f]{0,254}$",
"title": "Picture",
"description": "A file from the workspace's media library, written media:// and the file's id or name. A web address is refused."
},
"alt": {
"type": "string",
"maxLength": 120,
"title": "Alt text",
"description": "What the picture shows, for anyone who cannot see it."
}
},
"required": [
"url"
],
"additionalProperties": false,
"title": "Picture",
"description": "The speaker, as a still from the video or a portrait; any shape, the top of the picture is kept in view. Without one, the brand's own film or the creator's badge stands in."
},
"cta": {
"type": "object",
"properties": {
"label": {
"type": "string",
"maxLength": 28,
"title": "Button",
"description": "What the button says."
},
"detail": {
"type": "string",
"maxLength": 48,
"title": "Line under it",
"description": "An address, a handle, a phone number."
}
},
"additionalProperties": false,
"title": "Call to action",
"description": "The button at the end and the line under it, such as a web address, a handle or a phone number."
},
"disclaimer": {
"type": "string",
"maxLength": 120,
"title": "Small print",
"description": "A note that must be shown, such as Ad or Not medical advice."
},
"look": {
"type": "object",
"properties": {
"theme": {
"type": "string",
"enum": [
"brand",
"light",
"dark",
"bold"
],
"title": "Theme",
"description": "Brand: your brand's own colours and background. Light or dark: a page tinted with your brand colour. Bold: your brand colour as the page.",
"enumNames": [
"Brand colours",
"Light",
"Dark",
"Bold brand colour"
]
},
"pace": {
"type": "string",
"enum": [
"calm",
"standard",
"punchy"
],
"title": "Pace",
"description": "How things arrive: calm fades, a standard rhythm, or punchy slams and hard cuts.",
"enumNames": [
"Calm",
"Standard",
"Punchy"
]
},
"corners": {
"type": "string",
"enum": [
"square",
"soft",
"round"
],
"title": "Corners",
"description": "The shape of cards, pictures and buttons.",
"enumNames": [
"Square",
"Softly rounded",
"Round"
]
},
"align": {
"type": "string",
"enum": [
"start",
"centre"
],
"title": "Text alignment",
"description": "Where the text lines up.",
"enumNames": [
"At the start of the line",
"Centred"
]
},
"layout": {
"type": "string",
"enum": [
"overlay",
"split"
],
"title": "Layout",
"description": "Over the picture: the speaker fills the frame and the captions sit on it. Beside the picture: the speaker in a frame of their own, the captions on the page beside or under it.",
"enumNames": [
"Over the picture",
"Beside the picture"
]
},
"captionStyle": {
"type": "string",
"enum": [
"highlight",
"boxes",
"colour"
],
"title": "Caption style",
"description": "Highlight: the word being said on a pill of the brand colour. Boxes: every line on a card, the word in the brand colour. Colour: plain words, the one being said larger and in the brand colour.",
"enumNames": [
"Highlighted word",
"Text boxes",
"Coloured word"
]
},
"paging": {
"type": "string",
"enum": [
"words",
"sentence"
],
"title": "Words at a time",
"description": "A few words: two to five large words at a time, as in short videos. Whole sentence: the sentence stays, its words lighting up as they are said.",
"enumNames": [
"A few words",
"Whole sentence"
]
},
"logo": {
"type": "string",
"enum": [
"auto",
"free"
],
"title": "Logo",
"description": "The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.",
"enumNames": [
"The style's own",
"As it is, no plate or crop"
]
}
},
"additionalProperties": false,
"title": "Look",
"description": "How the clip looks and moves. The same five switches in every format (theme, pace, corners, alignment, logo), plus this format's own. Leave any out for the format's default."
}
},
"additionalProperties": false,
"title": "Clip data",
"description": "Everything drawn in the clip: the title chip, what is said, the backdrop and the call to action. The creator's name and picture are the brand's badge, the handle is the channel's (else the brand's second title line)."
},
"metaData": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 100,
"title": "Title",
"description": "Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes."
},
"captionTiny": {
"type": "string",
"maxLength": 200,
"title": "Tiny description (Pinterest, Threads, X)",
"description": "Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionShort": {
"type": "string",
"maxLength": 500,
"title": "Short description (Telegram, Threema, WeChat, WhatsApp)",
"description": "Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionMedium": {
"type": "string",
"maxLength": 1500,
"title": "Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok)",
"description": "Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"captionLong": {
"type": "string",
"maxLength": 4000,
"title": "Long description (Facebook Feed, YouTube)",
"description": "Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit."
},
"hashtags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60,
"title": "Hashtag"
},
"maxItems": 15,
"title": "Hashtags",
"description": "Written without the #. Up to 15, which every platform takes."
}
},
"additionalProperties": false,
"title": "Meta data",
"description": "Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data."
}
},
"additionalProperties": false
},
"propertyNames": {
"enum": [
"aa",
"ab",
"ae",
"af",
"ak",
"am",
"an",
"ar",
"as",
"av",
"ay",
"az",
"ba",
"be",
"bg",
"bi",
"bm",
"bn",
"bo",
"br",
"bs",
"ca",
"ce",
"ch",
"co",
"cr",
"cs",
"cu",
"cv",
"cy",
"da",
"de",
"dv",
"dz",
"ee",
"el",
"en",
"eo",
"es",
"et",
"eu",
"fa",
"ff",
"fi",
"fj",
"fo",
"fr",
"fy",
"ga",
"gd",
"gl",
"gn",
"gu",
"gv",
"ha",
"he",
"hi",
"ho",
"hr",
"ht",
"hu",
"hy",
"hz",
"ia",
"id",
"ie",
"ig",
"ii",
"ik",
"io",
"is",
"it",
"iu",
"ja",
"jv",
"ka",
"kg",
"ki",
"kj",
"kk",
"kl",
"km",
"kn",
"ko",
"kr",
"ks",
"ku",
"kv",
"kw",
"ky",
"la",
"lb",
"lg",
"li",
"ln",
"lo",
"lt",
"lu",
"lv",
"mg",
"mh",
"mi",
"mk",
"ml",
"mn",
"mr",
"ms",
"mt",
"my",
"na",
"nb",
"nd",
"ne",
"ng",
"nl",
"nn",
"no",
"nr",
"nv",
"ny",
"oc",
"oj",
"om",
"or",
"os",
"pa",
"pi",
"pl",
"ps",
"pt",
"qu",
"rm",
"rn",
"ro",
"ru",
"rw",
"sa",
"sc",
"sd",
"se",
"sg",
"si",
"sk",
"sl",
"sm",
"sn",
"so",
"sq",
"sr",
"ss",
"st",
"su",
"sv",
"sw",
"ta",
"te",
"tg",
"th",
"ti",
"tk",
"tl",
"tn",
"to",
"tr",
"ts",
"tt",
"tw",
"ty",
"ug",
"uk",
"ur",
"uz",
"ve",
"vi",
"vo",
"wa",
"wo",
"xh",
"yi",
"yo",
"za",
"zh",
"zu",
"zh-CN",
"zh-TW",
"pt-BR"
]
}
}
},
"required": [
"clipData"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
Ask Reelwire for the same document yourself, without signing in:
curl "http://localhost:4000/v1/formats/template/tpl_3245d6e9ee79?variant=Talking%20captions&version=1.0.0"
Delivery JSON
Your own system sends this to one of your streams, POST /v1/stream, and every channel listening to
that stream draws it with its template. data is the document described above; a stream with an
empty field map passes it to the template unchanged. Try it first on POST /v1/stream/validate,
which answers the same without publishing anything. Streams and feeds
explains the rest, including how to map a document of your own shape instead.
{
"streamId": "st_your_stream_id",
"eventId": "01M2SQMKK3G1NVFXV31DCBVB95",
"occurredAt": "2026-09-23T07:00:00Z",
"locale": "en",
"data": {
"clipData": {
"kicker": "Skin school, part 3",
"headline": "Three SPF mistakes I made for years (and the fix)",
"sentences": [
"For years I put on sunscreen once in the morning and thought I was done for the day.",
"Mistake one: the right amount for your face is two finger lengths, not a tiny dot.",
"Mistake two: reapply every two hours outdoors, yes, even on a cloudy autumn day.",
"Mistake three: forgetting your ears, neck and hands. They show it first, trust me."
],
"picture": {
"alt": "A person's silhouette on a round green ground",
"url": "media://example-badge.png"
},
"cta": {
"label": "Follow for part 4",
"detail": "New skin tips every Tuesday"
},
"disclaimer": "Not medical advice. Ask a dermatologist about your own skin.",
"look": {
"theme": "brand",
"pace": "standard",
"corners": "round",
"align": "centre",
"layout": "overlay",
"captionStyle": "highlight",
"paging": "words",
"logo": "auto"
}
},
"metaData": {
"title": "Three SPF mistakes I made for years",
"captionTiny": "Three SPF mistakes I made for years, and how I fixed them. Part 3 of skin school.",
"captionShort": "Three SPF mistakes I made for years: too little, never reapplied, and forgetting ears, neck and hands. Here is the fix for each. Part 3 of skin school, new tips every Tuesday.",
"captionMedium": "For years I put on sunscreen once in the morning and thought I was done. Mistake one: too little, the right amount for your face is two finger lengths. Mistake two: never reapplying, when outdoors it is every two hours, even on a cloudy autumn day. Mistake three: forgetting your ears, neck and hands, which show sun damage first. This is part 3 of skin school, with new tips every Tuesday. Not medical advice: ask a dermatologist about your own skin.",
"captionLong": "For years I put on sunscreen once in the morning and thought I was done for the day. Here are the three mistakes I made, and what I do now. Mistake one: too little. The right amount for your face is two finger lengths, not a tiny dot. Mistake two: never reapplying. When you are outdoors it is every two hours, yes, even on a cloudy autumn day, because most of the sun gets through the clouds. Mistake three: forgetting your ears, neck and hands, which are the first places to show sun damage. This is part 3 of skin school, with new skin tips every Tuesday, so follow along for part 4. Not medical advice: ask a dermatologist about your own skin.",
"hashtags": [
"skincare",
"spf",
"skinschool",
"miraglow"
]
}
}
}
The delivery names no version: which build draws it is the channel's choice, the newest of its
variant or the one it is pinned to. eventId is a ULID you make once per event: sending the same
one again changes nothing. occurredAt is when the thing happened, not when you sent it. locale
is the language of the text in data, and data.locales carries other languages beside it.