AdGPT

Read your profile, creative-credit balance, and in-flight generations; update your profile. No account yet? Start with register (or login) — the returned session token is adopted automatically and every later call runs as that user. Actions: register, login, me, credits, activeGenerations, updateProfile. Call adgpt_capabilities with the operationId to see an action's parameters.

Manage brands: list, get, create, update, delete, and auto-fetch details from a URL (costs 5 credits). Actions: list, get, create, update, delete, fetchDetails. Call adgpt_capabilities with the operationId to see an action's parameters.

Generate and manage Full Campaigns (FC) from a product URL, a manual product (name+description+images), or text-only. Each campaign generates (defaults): 6 image ads (3 with text + 3 clean), 4 video ads, 3 UGC presenter videos, 12 Google ad copy variations, 10 keywords, plus social captions. Tier (base/pro/premium) changes credit cost and UGC render quality, not asset counts. Re-render one image (regenerateAsset, credits only), download, or remove a campaign from your library. Actions: eligibility, create, status, assets, downloadAll, regenerateAsset, deleteFromLibrary. Call adgpt_capabilities with the operationId to see an action's parameters.

Search AdGPT operations or describe one in detail (input schema, auth, credit cost, async behavior). Use `operationId` to describe a specific operation, or `query` to search by name / domain / path.

Product feeds and items: import a feed (xml|shopify), poll import status, and read and update products. Actions: list, get, createFeed, updateProduct, importStatus. Call adgpt_capabilities with the operationId to see an action's parameters.

Post-generation editing of image and video assets: AI prompt edits, overlays (normalized geometry), video v2v + narration re-dub (voice/emotion/gender; language-dependent extras), version keep/discard/revert, caption edits, share links and social ad previews. In-action editing (inAction*) works on completed UGC in-action ads. editImage and imageOverlay are async: they return `candidate` with status processing (charged at submit, refunded if the edit fails) — poll imageVersions every ~5s until that version is candidate (then imageKeep / imageDiscard) or failed (show its error_message); never keep, discard or re-submit while it is still processing. Burned-in subtitles of a UGC presenter video: subtitleState reads the lines and the version token, subtitleApply fixes, retimes, adds, removes or hides them (each apply becomes a new version of the ad; poll subtitleState until rendering is false). Brand layer (the brand-font captions, plus logo mark or on-video titles, added to a finished Shorts, UGC Pro, Commercial or Film ad): brandLayer turns it off (enabled false) or back on, instantly and free; brand_layer on each ad in the campaign assets holds its state (null when there is nothing to switch). Actions: editImage, imageOverlay, uploadOverlay, imageVersions, imageKeep, imageDiscard, imageRevert, editVideo, videoOverlay, editNarration, previewNarration, videoVersions, videoKeep, videoDiscard, videoRevert, editCaption, shareLink, socialAdView, inActionState, inActionMusicTracks, inActionPrompt, inActionVoiceover, inActionVoiceoverPreview, inActionTagScript, inActionMusic, inActionRegenerate, inActionVersions, inActionKeep, inActionDiscard, inActionRevert, subtitleState, subtitleApply, brandLayer. Call adgpt_capabilities with the operationId to see an action's parameters.

Read-only status of your campaign's live ads: the current go-live, its history, and performance. Starting, renewing or stopping a go-live happens in the web app. Actions: current, history, performance. Call adgpt_capabilities with the operationId to see an action's parameters.

Smart Resize: subject-preserving platform-size renditions of your generated image ads — presets catalog, asset context, async batch (25 credits per size), batch status, and a campaign's existing renditions. Actions: smartPresets, smartResize, smartBatchStatus, smartAssetContext, smartCampaignRenditions. Call adgpt_capabilities with the operationId to see an action's parameters.

Talking-head / UGC-in-action wizard for a SAC campaign: generate scripts, strategies, and per-character plans; preview voices; tag scripts; persist wizard state. Read adgpt://pipeline/characters and adgpt://pipeline/voices first. In-action and commercial videos need a Pro plan or higher. Actions: generatePipelineScripts, generateStrategies, generatePlan, plans, getWizardState, saveWizardState, tagScript, voicePreview, voicePreviewStatus. Call adgpt_capabilities with the operationId to see an action's parameters.

Poll a long-running generation to completion. Pass the status `operationId` (from a create call's job handle) and its `params` (e.g. {id}). Waits up to `waitSeconds` (max 25); if not finished, returns callAgain=true — invoke again to keep waiting. Never charges credits.

Clone any existing ad: ingest it (URL or upload), analyze its hooks, script and scene structure, then generate your own version from one instruction (adGenerateFromPrompt). Poll adStatus; adCancel refunds an in-flight clone. Actions: adIngestUrl, adUpload, adAnalyze, adStatus, adGenerateFromPrompt, adCancel, adAssets. Call adgpt_capabilities with the operationId to see an action's parameters.

Generate a BATCH of premium creatives of one asset type (SAC), or bulk-order N assets in one request (bulk* actions: pricing, order, status, assets, cancel — credits charged upfront, failed items auto-refund) — image: 6 image ads (3 with text + 3 clean) · video: 4 video ads · ugc_video: 3 UGC presenter videos · google_ads: 12 ad variations · ugc_action: 3 UGC in-action videos. create → (customize) → confirm. Interactive UGC/in-action uses confirm sub-payloads. pricing / eligibility quote the credit cost first. Talking Actors "Create Variations": variationsQuote (free) says whether a finished Talking Actors video can get 3 new videos of the same actor acting its script in 3 places that fit it, and the exact credits; createVariations spends credits (that figure) and returns the new campaign_id to poll. Actions: pricing, eligibility, create, confirm, cancel, status, assets, regenerateAsset, downloadAll, variationsQuote, createVariations, bulkPricing, bulkOrder, bulkStatus, bulkAssets, bulkCancel. Call adgpt_capabilities with the operationId to see an action's parameters.

Connect your own Facebook ad account, check connections, and publish to TikTok from an account you already connected in the web app: campaign/ad-group reads, targeting taxonomy, and create-ads. Actions: connectAccount, checkConnection, facebookExchangeToken, tiktokRegions, tiktokLanguages, tiktokCampaigns, tiktokAdGroups, tiktokCreateAds. Call adgpt_capabilities with the operationId to see an action's parameters.

Browse the UGC presenter avatar and voice catalogs. (UGC videos themselves are generated through adgpt_campaigns, adgpt_single_asset and adgpt_in_action.) Actions: avatarsPaginated, voices. Call adgpt_capabilities with the operationId to see an action's parameters.

Upload a product photo to AdGPT from the local machine — pass an absolute file_path (preferred) OR data_base64 (+ filename). Validates it is a usable product image (min 100×100px, aspect between 1:4 and 4:1), stores it, and returns {url, width, height}; pass that url in user_instructions.uploaded_images when creating a campaign (up to 5). Formats: jpeg/png/webp/gif/bmp, max 10MB. Works before login too.