Product description → AI ad

Take a paragraph (or bullet list) describing a product and produce a polished short-form ad. The ad-generator workflow writes the hook + body + CTA itself based on the description.

When to use this skill

• The user pastes a product description, spec sheet, or feature list — not a URL.
• They want hook → benefit → CTA structure (a commercial).
• They have no avatar / talking-head requirement (use revid-blog-to-avatar-video for that).
• For a live URL, use revid-shopify-product-promo.

Inputs

Step-by-step

1. Validate prompt has at least ~30 words (otherwise the ad is too thin).
2. Build the payload below; if product images were provided, slot them into media.provided and set media.useOnlyProvided: false (mix with stock).
3. POST /render.
4. Poll /status.
5. Return videoUrl.

API call template

POST /api/public/v3/render
Host: www.revid.ai
Content-Type: application/json
key: $REVID_API_KEY

{
  "workflow": "ad-generator",
  "source": {
    "prompt":      "{PRODUCT_DESCRIPTION}",
    "stylePrompt": "{OPTIONAL_BRAND_VOICE_NOTES}",
    "durationSeconds": 22
  },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "stability": 0.55, "speed": 1.05, "language": "en-US" },
  "captions": { "enabled": true, "position": "middle", "autoCrop": true },
  "music":    { "enabled": true, "syncWith": "beats", "trackName": "ad-energetic" },
  "media": {
    "type": "stock-video",
    "density": "high",
    "animation": "dynamic",
    "quality": "ultra",
    "imageModel": "ultra",
    "videoModel": "ultra",
    "turnImagesIntoVideos": true,
    "applyStyleTransfer": false,
    "provided": []
  },
  "options": {
    "targetDuration": 22,
    "promptTargetDuration": 22,
    "summarizationPreference": "summarizeIfLong",
    "soundEffects": true,
    "addStickers": true,
    "hasToGenerateCover": true,
    "coverTextType": "hook"
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

ad-generator defaults to higher visual quality than article-to-video because ads compete on the first second. If credits are tight drop quality to pro.

Examples

• examples/aeropods-ad.json — payload with brand notes.
• examples/run.sh — accepts description as a file or positional arg.

Failure modes