remix_from_swipe_file
Remix a Swipe File reference into on-brand draft creatives: kicks off
generation of count images seeded by the reference (its extracted angle
- copy + curator notes) plus this org’s brand grounding, each stored as a draft AdCreative reviewable in the Creatives tab.
BILLS image-generation credits per draft (same rate as generate_ad_image). Runs ASYNCHRONOUSLY — this returns immediately with a PENDING job; each draft takes ~10-60s and appears in the Creatives library (lifecycle=draft) when ready. Tell the user the drafts are being generated and will show up in Creatives shortly; do not block waiting on them.
Args: item_id: The swipe-file item to remix (needs a stored image) guidance: Optional steering text woven into the specs count: Draft variants to generate (1-4, default 1) platform: Target platform for the drafts (default: the item’s)
Returns: A dictionary containing:
- job: {id, status, requested_count, specs} — status is ‘pending’
- message: human-facing note about where the drafts will appear
- source: provenance tag
Parameters#
| Name | Type | Required | Default |
|---|---|---|---|
item_id | string | yes | |
guidance | string | no | |
count | integer | no | 1 |
platform | string | no |
Generated from the server tool’s docstring by generate_mcp_docs. Extend this page freely — the generator never overwrites an existing file.