AdGPT

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.

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.

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.

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.

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.

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. Actions: pricing, eligibility, create, confirm, cancel, status, assets, regenerateAsset, downloadAll, bulkPricing, bulkOrder, bulkStatus, bulkAssets, bulkCancel. 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.

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.

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. 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. 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.

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.

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.

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.

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.

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.