Skip to content
AdlyseDocs
Product guideMCP reference
⌘K
Open Adlyse
⌘K
Overview
QuickstartAuthentication
adlyse-insights
adlyse-ads
list_ad_accountsget_platform_supportget_ad_creation_capabilitiesget_ad_build_specupdate_ad_build_speclist_ad_plansget_ad_plan_publicationget_ad_planimport_ad_to_planimport_live_ad_to_plancreate_ad_plan_variantsadd_ad_plan_variantsupdate_ad_plan_groupgroup_ad_plansget_ad_plan_groupfreeze_ad_plan_grouppublish_ad_plan_groupcreate_ad_plancreate_ad_edit_planupdate_ad_planattach_ad_plan_assetfill_ad_plan_slotsfreeze_ad_planpublish_ad_planresolve_ad_publish_steplist_campaignsget_performancelist_change_eventslist_adsget_ad_performancelist_creative_librarylist_experimentsget_experimentpause_experimentresume_experimentstop_experimentpause_creative_adsupdate_ad_group_statusupdate_ad_statusupdate_campaign_statusupdate_campaign_budgetlist_swipe_filesave_competitor_ad_to_swipe_filesave_creative_to_swipe_fileremix_from_swipe_filestart_creative_jobresize_creativemake_variants_of_winnerget_creative_jobestimate_creative_batchstart_creative_batchbatch_to_plan_groupget_creative_batchsnapshot_catalog_productsgenerate_ad_copylist_ad_copycreate_creative_conceptrequest_creative_reviewget_creative_review
adlyse-workflows
adlyse-admin
adlyse-all
  1. Overview
  2. adlyse-ads

remix_from_swipe_file

Remix an Inspiration 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 Library.

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 Library (lifecycle=draft) when ready. Tell the user the drafts are being generated and will show up in the Library 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-10, default 1) platform: Optional platform hint for the drafts (default: the item’s, when known) request_key: Optional key; a retry with the same key returns the same remix ad_account_id: Optional account the drafts are for (grounding scope)

Returns: A dictionary containing:

  • job: the creative job (id, kind, status, requested_count, outputs); poll get_creative_job with its id
  • message: human-facing note about where the drafts will appear
  • source: provenance tag

Parameters#

NameTypeRequiredDefaultDescription
item_idstringyesSwipe-file item id (from list_swipe_file).
guidancestringnoOptional steering — offer, product, audience, tone to emphasize.
countintegerno1Draft variants to generate (1-10, default 1).
platformstringnoOptional platform the drafts are meant for (‘meta’, ‘google’, …); defaults to the item’s own when known. The ad plan that uses a draft chooses where it runs.
request_keystringnoOptional key you choose for this remix; reuse it when retrying the same remix so it is not started twice.
ad_account_idstringnoOptional ad account the drafts are for: grounds them on that account’s winning angles rather than the whole platform’s.

Generated by generate_mcp_docs from the server tool. Add to this page below this block; the block is rewritten on every run.

Previoussave_creative_to_swipe_fileNextstart_creative_job