add_product
ChatGPTAdd a product to the user's VOVV.AI studio from a store product page link (Shopify, WooCommerce, Etsy, any shop) or a direct picture link. Saves photos, name, category and description, then returns the new product_id for the generate_* tools. Free. Use it whenever the user shares a product that is not in list_products yet.
generate_freestyle_image
ChatGPTCreate images from a written idea, like the Freestyle page in VOVV.AI, optionally using one of the user's products, a model and a scene. First call without confirm to get the credit cost, show it to the user, then call again with confirm: true. Returns job ids; use get_job_status for results.
generate_freestyle_video
ChatGPTCreate a short video (5 or 10 s) from a written idea, like the Video mode on the Freestyle page. Optionally guide it with a product, model and scene, or start from an image URL (e.g. a Library image). First call without confirm to get the cost, show it, then call again with confirm: true. Videos take a few minutes; use get_job_status.
generate_product_images
ChatGPTCreate product photos of one of the user's products in chosen scenes, optionally with models, one image per scene × model. Scenes can be scene_ids from search_scenes / recommend_setup or plain words. First call without confirm to get the credit cost, show it, then call again with confirm: true. Use get_job_status for results.
get_account
ChatGPTReturn the signed-in VOVV.AI user's profile summary: display name, plan, current monthly credit balance, purchased top-up balance, subscription status, billing interval, and the date the current billing period ends. Use this to answer questions like 'how many credits do I have?' or 'what plan am I on?'.
get_job_status
ChatGPTCheck images or videos started with the generate_* tools. Returns status and, when finished, picture/video links to show the user.
get_product
ChatGPTFetch full details for one of the signed-in user's products by id, including metadata (dimensions, weight, materials, color, SKU) and every reference image (front, back, side, packaging, inside, texture, extras). Use list_products first to discover product ids.
get_studio_guide
ChatGPTExplains what VOVV.AI can create and returns the live list of scene categories (with counts and examples), model counts, image shapes, video options and credit prices. Call this first when helping a user create images or videos.
list_brand_profiles
ChatGPTList the signed-in user's saved brand profiles · name, tone, lighting style, background style, colour palette, keywords, and target audience. Use this to see the aesthetics VOVV.AI applies when generating visuals for this user.
list_library_assets
ChatGPTList the signed-in user's generated visuals from their VOVV.AI library: studio shoots, Create with Prompt images and videos, newest first. Images are shown inline; videos come with a play link.
list_products
ChatGPTList products the signed-in VOVV.AI user has uploaded to their library. Returns id, title, product_type, description, primary image, and creation date. Use this to discover product IDs before calling other product-related tools.
recommend_setup
ChatGPTGiven one of the user's products (and an optional goal like 'Instagram ad' or 'website hero'), suggests fitting scenes, a few models when people make sense, and the best image shape. Use it when the user doesn't know which scenes or models to pick.
search_competitor_ads
ChatGPTSearch the VOVV.AI Ad Library of running Meta (Facebook/Instagram) ads by keyword, category or format. Returns brand, ad copy, how long it has run, and the ad picture or video.
search_competitor_blogs
ChatGPTSearch competitor blog articles collected by VOVV.AI. Returns brand, title, topic, reading time, section headings, the article link and its cover picture.
search_competitor_emails
ChatGPTSearch competitor newsletter emails collected by VOVV.AI. Returns brand, subject line, preview text, offer, the email's text and a picture of the email.
search_competitor_social
ChatGPTSearch competitor social media posts collected by VOVV.AI. Returns brand, caption, likes, comments, views, post date and the post picture or video.
search_models
ChatGPTSearch VOVV.AI models by name or look (gender, ethnicity, body type). Covers the user's own brand models and the VOVV.AI studio models. Use the returned model_id when choosing a model for a shoot.
search_scenes
ChatGPTSearch VOVV.AI's 2,900+ scenes by plain words · mood, setting, style or place (e.g. 'sunny bathroom', 'beach', 'white studio', 'moody') · optionally within a product category. Each word is matched against title, sub-category, setting, mood, style and description. Suggest the best 3-5 to the user with their pictures, then use scene_id in generate_* tools.