Character References for Social AI Media + First Comment Field

Pass referenceAssetIds on social media generate for consistent character crops across ratios. Draft posts now include firstComment for the link-in-comments pattern — reviewed in the dashboard, dispatch when Chirio ships comment publishing.

Updated 20d ago

In short

Social AI generation accepts up to three library reference images (character sheets) alongside aspectRatios. Post drafts and API payloads add firstComment for link-in-comments copy — reviewed like the caption, held until Chirio publishes comments.

What we shipped

Multi-aspect AI media gave agents platform-fit crops in one call. This follow-up adds visual consistency across those crops and a first comment field for a common Instagram workflow.

Character and style references

POST /api/v1/social/media/generate now accepts referenceAssetIds — up to three library asset IDs. Register a character or style sheet with POST /api/v1/social/media, then pass its id when generating. The reference images are sent to the model with your prompt so square, portrait, and landscape crops stay on-brand. References work together with aspectRatios, but image providers only honor a few shapes on reference calls (GPT image models: square, landscape, portrait). Each requested ratio maps to the nearest supported shape, so returned assets are tagged with the delivered ratio — not always the one you asked for. Provenance is stored on each asset as referenceAssetIds. The MCP tool aveiro_social_generate_media accepts the same list as reference_asset_ids.

First comment field

Social post drafts now include firstComment — optional text for the link-in-comments pattern. Put URLs and CTAs in first comment instead of the caption.

Dashboard — First comment textarea on every post in Dashboard → Social
API and MCP — firstComment on POST and PATCH /api/v1/social/posts; first_comment on aveiro_social_create_draft and aveiro_social_update_draft

First comment is reviewed like the caption. Editing it after approval revokes approval. Dispatch does not send it yet — copy is stored and reviewed now; it will post automatically once Chirio ships comment publishing.

Why we built it this way

Teams running a mascot or illustrated brand were generating four crops from one prompt and getting four different characters. Reference images fix that without a separate img2img pipeline. The link-in-comments pattern is standard on Instagram — captions stay readable, links live in the first comment. Aveiro stores that copy in the draft so reviewers see the full post before approval, even before the publish pipe can post comments.

Setup checklist

Step	Where
Register a character sheet	POST /api/v1/social/media with a public image URL
Generate with references	POST /api/v1/social/media/generate with referenceAssetIds + aspectRatios
Attach crops to a draft	mediaAssignments on POST /api/v1/social/posts
Add first comment	firstComment on create/update — or First comment in the dashboard
Approve as usual	Dashboard → Social — first comment reviewed but not sent until Chirio ships it

Try it

Register a character sheet: POST /api/v1/social/media with your sheet URL.
Generate crops: referenceAssetIds: ["…"] and aspectRatios: ["1:1", "4:5"] on /api/v1/social/media/generate.
Create a draft with firstComment: "Read more: https://yoursite.com/post" and a short caption without the URL.
Submit for review — approvers see caption, media, and first comment together.

References work together with aspectRatios, but image providers only honor a few shapes on reference calls (GPT image models: square, landscape, portrait). Each requested ratio maps to the nearest supported shape, so returned assets are tagged with the delivered ratio — not always the one you asked for. Provenance is stored on each asset as referenceAssetIds.

The MCP tool aveiro_social_generate_media accepts the same list as reference_asset_ids.

First comment field

Social post drafts now include firstComment — optional text for the link-in-comments pattern. Put URLs and CTAs in first comment instead of the caption.

Dashboard — First comment textarea on every post in Dashboard → Social

API and MCP — firstComment on POST and PATCH /api/v1/social/posts; first_comment on aveiro_social_create_draft and aveiro_social_update_draft

Why we built it this way

Teams running a mascot or illustrated brand were generating four crops from one prompt and getting four different characters. Reference images fix that without a separate img2img pipeline.

The link-in-comments pattern is standard on Instagram — captions stay readable, links live in the first comment. Aveiro stores that copy in the draft so reviewers see the full post before approval, even before the publish pipe can post comments.

Setup checklist

Step	Where
Register a character sheet	POST /api/v1/social/media with a public image URL
Generate with references	POST /api/v1/social/media/generate with referenceAssetIds + aspectRatios
Attach crops to a draft	mediaAssignments on POST /api/v1/social/posts
Add first comment	firstComment on create/update — or First comment in the dashboard
Approve as usual	Dashboard → Social — first comment reviewed but not sent until Chirio ships it

Try it

Generate crops: referenceAssetIds: ["…"] and aspectRatios: ["1:1", "4:5"] on /api/v1/social/media/generate.

Create a draft with firstComment: "Read more: https://yoursite.com/post" and a short caption without the URL.

Submit for review — approvers see caption, media, and first comment together.

Character References for Social AI Media + First Comment Field

Character References for Social AI Media + First Comment Field

What we shipped

Character and style references

First comment field

Why we built it this way

Setup checklist

Try it

Read next

What we shipped

Character and style references

First comment field

Why we built it this way

Setup checklist

Try it

Read next