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

start_creative_job

Start a creative job on one of this organization’s creatives. Runs in the background and returns the PENDING job at once; poll get_creative_job.

  • iterate: plans new angles from brand grounding and the angles that won or lost in this org’s results, then edits the source image once per angle. Each result is a draft creative whose parent is the source. BILLS image-generation credits per variation.
  • resize: fits the image to each target shape without cropping it, as a draft child of the source. Pad is free. Extend generates scenery into the border, is billed per shape, and waits (status awaiting_accept) until the user previews and accepts it in the Studio.

Returns: job: id, kind, status, requested_count, outputs (index, status, creative_id, error)

Parameters#

NameTypeRequiredDefaultDescription
kindstringyes’iterate’ (new angles on the creative, billed per image) or ‘resize’ (fit it to other platforms’ shapes by padding, free).
source_creative_idstringyesCreative id from the library (ad_crtv_…).
request_keystringyesA key you choose for this request. Reuse it when retrying the same request; a new request needs a new key.
countintegernoiterate: variations to make (1-12, default 3).
guidancestringnoiterate: what to change or emphasize.
platformstringnoiterate: optional platform whose copy limits and performance grounding to use; omit to iterate for no platform in particular.
targetsarraynoresize: exact shapes, each with platform and asset_type (e.g. meta_ads / VERTICAL_9X16), plus aspect_ratio [w, h] for a recommended ratio (tiktok_ads / IMAGE / [9, 16]). Use this or platforms.
platformsarraynoresize: every ad image shape these platforms take. Use this or targets.
modestringnoresize: ‘pad’ (default, free) centres the image on a blurred fill of itself. ‘extend’ generates real scenery into the border (billed per shape) and waits until the user previews and accepts it in the Studio; nothing is billed before that.

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

Previousremix_from_swipe_fileNextresize_creative