AI Content Drop

Decode a saved competitor ad into a reusable formula: hook, script, scenes, audio, call to action and style, plus a generation-ready recreation prompt. Requires a quote_id from estimate_ad_cost with kind "decode" (a flat price). Credits are charged only when the analysis succeeds; an ad decoded before returns its stored decode and charges nothing.

decode_ad

Price a studio job before making it: a finished ad from a brief or storyboard (kind "ad"), a UGC creator video (kind "ugc"), a generated avatar (kind "avatar") or a competitor-ad decode (kind "decode"). Returns the credit lines, the total and a quote_id that generate_ad, generate_ugc_video, generate_avatar and decode_ad require. No account needed. For an ad, quote exactly the fields you will submit.

estimate_ad_cost

Price a video or image before making it. Returns the exact credit cost and a quote_id that generate_video and generate_image require. No account needed. Pass the duration and resolution you intend to use; some video models bill per second.

estimate_credit_cost

Make a UGC-style creator video: a catalogue creator (template from list_ugc_avatars) or a person's own photo (image_url) speaks the script with lip-sync, optional voice choice and ambience. Requires a quote_id from estimate_ad_cost with kind "ugc", and image_rights_consent: true given by the person. Returns an id to poll with get_generation. Credits are charged only on success.

generate_ugc_video

Make a finished video ad — multi-shot, with a speaking creator, product shots, captions and an optional music bed — from a brief or a storyboard plus an avatar image and a product image. Requires a quote_id from estimate_ad_cost for exactly these fields; returns a job_id to poll with get_ad_job. Credits are charged only when the ad succeeds, and never more than the quote.

generate_ad

Generate a creator portrait (Nano Banana) to use as the avatar in generate_ad, checked for hands, face and background defects. Requires a quote_id from estimate_ad_cost with kind "avatar". Finishes within the call; credits are charged only when a portrait comes back.

generate_avatar

Make an AI image: a product still, a thumbnail, a poster, concept art, or a reference frame to animate later. Requires a quote_id from estimate_credit_cost so the price is agreed first; then returns a job id to poll with get_generation (kind "image"). Credits are charged only when the image succeeds.

generate_image

Make an AI video: a product ad, a vertical clip for social, a cinematic shot, or animate a photo into video (image-to-video). Requires a quote_id from estimate_credit_cost so the price is agreed first; then returns a job id to poll with get_generation. Credits are charged only when the video succeeds.

generate_video

Read one drama in full: its cast, episodes with scenes, beats and dialogue, each clip's renders, a draft waiting for review, the jobs in flight, each episode's finished cut, and what to do next. Costs no credits. Call this to follow writing, rendering and cutting.

get_drama

Read one drop in full: its phase and status, its latest reply, everything it has made keyed by kind, the decision it is waiting on if any, its board link, and its own narration of the work. Costs no credits. Call this to poll while a drop is running, and after message_video_agent says it is still working.

get_video_agent_run

Check the signed-in account's remaining credits and current plan name before generating, and get the informational page about plans and entitlement.

get_account

Check an ad job: stage and percent while it renders, then the finished video URL, the storyboard sheet, duration, size and the credits charged. Poll every 15 seconds after generate_ad; stop after 15 minutes.

get_ad_job

Fetch the full text of one published article as markdown, by slug.

get_article

Read one board in full: every card with its type, position, size and data, the edges, and the revision. Generation cards that are still rendering are checked against their jobs on every read. Shows the board as a view; a board already on screen updates itself, so call this to show a board that is not. Costs no credits.

get_canvas

Get the link to a board's page on AI Content Drop so the person can open it in a browser or the host's embedded browser panel. Costs no credits.

get_canvas_link

Check whether a video or image is finished and get its URL. Poll this after generate_video or generate_image; pass kind "image" for an image job. Reports status, the finished file URL, and the credits charged.

get_generation

Read one saved competitor ad in full, with its stored decode (the ad's formula and a recreation prompt) when it has one. Costs no credits; never runs a decode.

get_saved_ad

Wrap chosen cards in a labelled frame that encloses them. Returns the board and the new frame. Costs no credits.

group_cards

Copy a public image (JPEG, PNG or WebP, at most 10 MB) onto AI Content Drop so it can be used as an avatar, product or photo reference. Returns the hosted URL. Costs no credits.

import_asset

Read a brand's website and save a brand profile from it: name, value props, CTA, tone and product images. Costs no credits. Low-confidence reads are returned for confirmation instead of being saved.

import_brand_profile

See the catalogue creators available for a UGC video — name, style and a portrait URL — and the fields generate_ugc_video accepts. No account needed. A person's own photo can be used instead, with their consent.

list_ugc_avatars

See the ad formats the studio can produce — UGC, talking head, unboxing, tutorial, TV spot, product hero, hyper-motion, try-on and more — with a one-line description, the default aspect and the allowed shot count and duration. No account needed. Pick one before writing a brief.

list_ad_formats

List the account's boards (visual canvases), newest first: id, name, revision, card count and the board's page link. Costs no credits. Start here to pick a board or to see that none exists yet.

list_canvases

List the account's saved brand profiles — name, site, value props, CTA, tone, product images — so ads for the same brand reuse the same facts.

list_brand_profiles

List the account's dramas, newest first: id, title, premise, episode count and version. Costs no credits. Start here to pick up a drama from an earlier session.

list_dramas

List the account's recent video generations, newest first, with their status and URLs.

list_generations

See which AI video or image models can make a video ad, animate a photo, produce a product clip or generate an image, with the credit cost of one generation. No account needed. The list is live; `count` is the number of models currently offered.

list_models

List the competitor ads saved on the account, newest first: id, advertiser, hook, media and whether a decode is stored. Costs no credits. Start here to pick an ad to decode or place on a board.

list_saved_ads

List the account's drops, newest first: id, title, goal, phase, status, credits charged so far and the board each one builds on. Costs no credits. Start here to pick up a drop from an earlier session.

list_video_agent_runs

Send a message to a drop and read its reply with everything it has made so far: an answer to its intake questions, a change to the brief, or a nudge to continue. The drop plans and produces with the tools listed on this server (search_competitor_ads, write_ad_storyboard, create_canvas, generate_video, generate_image, generate_ad) and never spends on its own: a step that would charge stops as pending_approval until approve_video_agent_spend releases it, unless the drop's owner set a credit limit on the website, in which case priced steps within the limit start by themselves and messaging that drop needs generations:create. Without a run_id a new drop is started from the message. Messaging costs no credits. A turn longer than about 40 seconds comes back as still working (status running, answer empty) and keeps going; follow it with get_video_agent_run, whose answer holds the reply once it lands.

message_video_agent

Move one or more cards to new positions on a board. The server places new cards itself; this is for the board view's drag. Costs no credits.

move_cards

Price an episode's video clips before anything renders. Marks the episode's script as ready for production, prepares each clip's shot, and returns one quote per clip that has no current render, with its credits and a quote_id valid for 10 minutes. Costs no credits; show the total to the person before produce_drama_episode.

quote_drama_episode

Re-read a board (same answer as get_canvas). Call it every 10 seconds while a generation card is rendering; a finished render sets the card's status to done and its media_url. It opens no new view: a board already on screen refreshes itself. Costs no credits.

refresh_canvas

Rename a board. Costs no credits.

rename_canvas

Render an episode's clips. Pass the clip_id and quote_id pairs quote_drama_episode returned; each clip renders at its quoted price and is charged only if it succeeds. Returns at once; follow the renders with get_drama. A lapsed or changed quote is refused and nothing is charged.

produce_drama_episode

Accept or reject a written draft (get_drama's pending_draft). Accepting makes it the drama's script; clips are priced from it afterwards. Costs no credits. A draft written before the drama last changed can no longer be accepted; ask for a fresh one with revise_drama.

review_drama_draft

Ask the writer for a new draft of a drama, or of one episode: a change of tone, a new ending, sharper dialogue, or a first draft if none was written. Returns at once; the draft lands as pending_draft on get_drama. Costs a few credits, charged only when the draft lands.

revise_drama

Render a generation card: its prompt and model become a video or image job whose result lands in the card. Requires a quote_id from estimate_credit_cost for the card's model and kind (quantity 1), taken with the card's duration and resolution when it has them: per-second models are priced from those, and the quote is verified against the card. A card added with from_card_id and no image_url starts from its source card's finished image; until that card is done the run is refused with nothing charged. Credits are charged only on success; a retry with the same quote_id returns the same job.

run_generation_card

Keep one ad from search_competitor_ads on the account so it can be decoded and placed on a board. Pass the row exactly as returned. Costs no credits. Saving the same ad twice returns the existing saved ad.

save_competitor_ad

Search AI Content Drop's published guides and model comparisons about AI video generation, prompting, and ad creative.

search_articles