Tools reference
You rarely call these by name: ask in plain words and your assistant picks the tool. Tools that make a video spend credits and return a job_id; the video renders in the background and get_job_status tells you when it is ready.
create_ad
Section titled “create_ad”A multi-scene advert from a brief, through the full Studio pipeline: it plans the scenes, then renders them.
| Input | ||
|---|---|---|
brief |
required | What it is for: product, audience, angle, mood (3-2,000 characters). |
scene_count |
optional | 2-6 scenes, default 4. |
aspect |
optional | 16:9 (default), 9:16 for Reels, TikTok and Shorts, or 1:1. |
branded |
optional | true applies the brand kit saved on your account: logo, colours and end card. If you have none, the call stops before charging anything. |
product_image_url |
optional | A public image of the product to feature. |
title, idempotency_key |
optional |
Costs: 1 credit to plan, then the render. If the render cannot start, the planning credit is refunded. Try: “Make a 4-scene vertical ad for our oat-milk latte, warm and cosy, with my brand.”
create_presenter_video
Section titled “create_presenter_video”A presenter reads your script to camera. Costs: priced by script length, shown in the reply as credits_charged.
| Input | ||
|---|---|---|
script |
required | The exact words (5-2,000 characters). |
title, idempotency_key |
optional |
Try: “Make a presenter video that says: Welcome to the team, here is how to book your first shift.”
create_launch_video
Section titled “create_launch_video”A short presenter promo for an app or product; the script is written for you and returned with the job. Costs: priced by script length.
| Input | ||
|---|---|---|
app_name, description |
required | Name, what it does and who it is for. |
website_url, idempotency_key |
optional |
Try: “Make a launch video for Northwind, a budgeting app for freelancers.”
get_job_status
Section titled “get_job_status”Free. Returns status (queued, processing, completed or failed), progress 0-100, and video_url once completed. Renders usually take a few minutes; a failed render refunds what it charged. Only jobs on your own account are visible.
get_account
Section titled “get_account”Free. Your name, email, plan and credits remaining.