Ads on Demand

Send one URL and get paid-social ads back. It can be an online store, a single product page, a service business's site, or an App Store / Google Play listing. VidGuy reads the page, finds the real products, prices, reviews and offers, and builds the ads from them. You don't need to set up a brand first.

Available on the Pro and Scale plans, through the API (POST /api/v1/snacks/on-demand) and the MCP tool generate_ads_from_url.

Ad types

A store gets 3 static-ad + 1 ugc-ad when you don't name any types (7 ads: 6 images and 1 video). A service business or an app gets 1 ugc-ad + 1 animated-ad. animated-ad, greenscreen-ad and music-ad only run when you ask for them.

Music ads

music-ad turns your product into a short animated music video:

1. The agent picks the song and the look. It chooses a genre that suits the product and its audience, such as doo-wop for a vintage soda, stomp-folk for travel shoes or K-pop for skincare. It also picks an animation style, such as a 1930s rubber-hose cartoon, felt stop-motion or claymation.
2. The story comes first. The first part of the song sets up a relatable moment with no product on screen. The product is revealed in the last section, and the brand name is sung in the hook.
3. The character sings on camera. The song is generated first. Each ~10-second section is then animated with that part of the song, so the character's mouth follows the vocals. The full song plays over the final cut, with a hook caption and an end caption.

Want a specific genre, look or story? Say so in prompt, for example "moody late-night jazz club" or "surf rock, 80s cartoon", and the agent follows it.

Make a request

curl -X POST https://www.vidguy.ai/api/v1/snacks/on-demand \
  -H "Authorization: Bearer vf_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "shopUrl": "https://drinkolipop.com/products/vintage-cola",
    "types": ["music-ad", "static-ad"],
    "prompt": "summer picnic vibe",
    "language": "en",
    "render": true
  }'

Reading the page takes 15–30 seconds before the 201 comes back, so give the request an HTTP timeout of at least 90 seconds. The response has a jobId; poll GET /api/v1/jobs/{id} (see Polling). Most ads are ready in 1–3 minutes. With render: true, the finished PNG and MP4 files are listed in result.renderedAssets[].

What stays true

Every number, price, rating, review quote, discount code and press mention in an ad comes from the page. Reviews have to appear word for word on the page, or we drop them. Presenters never claim they've used the product themselves. Ads don't address the viewer's health, body or finances. The real product photo anchors every ad, and static images and presenter shots are checked against it by a vision model before they ship.

Languages

Ads are written in English unless you pass language. When you do, the on-screen text, scripts, lyrics and primaryText are all written in that language, the way a native speaker would say them. Voice-overs use a native speaker of that language wherever the voice library has one; for a few languages, such as Albanian, a multilingual voice reads it instead. If the store's page is in a different language from the ads, its facts and reviews are translated, while brand names, product names, prices and discount codes stay exactly as the store writes them.

Pricing

A store's default pack is 52 credits (55 rendered). Credits are reserved when the job starts and refunded automatically if it fails.