ad_to_canvas_card
ChatGPTPlace a saved competitor ad on a board as a media card (its video or image, the advertiser as title, the hook as caption) with its decoded brief attached when it has one. Costs no credits. Returns the whole board and the new card.
add_frame
ChatGPTAdd a labelled frame (a region such as Week 1 or Hooks) to a board. To wrap existing cards in a frame use group_cards instead. Costs no credits.
add_generation_card
ChatGPTAdd a draft generation card to a board: a prompt and a model (an id from list_models) that can be rendered later with run_generation_card. Adding it costs nothing; nothing renders until it is run with a quote. Set duration and resolution on the card for a per-second model: the quote for run_generation_card must be taken with them. For a step that builds on an earlier card (a still that becomes a video), pass from_card_id: the new card is connected to that card on the board and, unless it has its own image_url, starts from that card's finished image.
add_media_card
ChatGPTAdd an image or video card to a board from a public https URL (an import_asset result, a finished generation's video_url, or an ad's video_url). Costs no credits. Returns the whole board and the new card.
add_text_card
ChatGPTAdd a text card (a note, an idea, a script line) to a board. The server places it on a grid unless a position is given. Costs no credits. Returns the whole board and the new card.
approve_video_agent_spend
ChatGPTAnswer the decision a drop is waiting on. This is the ONLY tool that lets a drop charge credits: pass the task_id and quote_id exactly as get_video_agent_run gives them in pending_approval, with decision approve to let that one step run or decline to cancel it. The quote fixes the credit ceiling, credits are charged only if the step succeeds, and approving the same quote twice does nothing the second time. A quote that is not the one on the step is refused, and so is one whose price has lapsed — in that case nothing is released and the engine prices the step again by itself, so call get_video_agent_run for the new quote_id.
arrange_cards
ChatGPTLay chosen cards (or the whole board) out as a grid, a row or a column. Costs no credits.
assemble_drama_episode
ChatGPTCut an episode into one video once every clip has a current render, using the newest render of each clip unless one is already chosen. Costs no credits; needs a paid plan. Returns at once; the finished video appears as episodes[].cut.video_url on get_drama.
connect_cards
ChatGPTConnect two cards on a board with a line from one to the next, so the board reads as a flow: a script card to the card that renders it, an idea to each of its variations. Costs no credits. Refuses a card connected to itself, a frame, and a connection that is already there. To make an image card's result the start frame of a new card, add that card with add_generation_card and from_card_id instead.
create_canvas
ChatGPTCreate a new, empty board and return it. Costs no credits. Use one board per plan or campaign; cards are added with the add_* tools.
decode_ad
ChatGPTDecode 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.
estimate_ad_cost
ChatGPTPrice 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_credit_cost
ChatGPTPrice 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.
generate_ad
ChatGPTMake 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_avatar
ChatGPTGenerate 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_image
ChatGPTMake 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_ugc_video
ChatGPTMake 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_video
ChatGPTMake 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.
get_account
ChatGPTCheck the signed-in account's remaining credits and current plan name before generating, and get the informational page about plans and entitlement.
get_ad_job
ChatGPTCheck 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_article
ChatGPTFetch the full text of one published article as markdown, by slug.
get_canvas
ChatGPTRead 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_link
ChatGPTGet 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_drama
ChatGPTRead 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_generation
ChatGPTCheck 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_saved_ad
ChatGPTRead 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_video_agent_run
ChatGPTRead 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.
group_cards
ChatGPTWrap chosen cards in a labelled frame that encloses them. Returns the board and the new frame. Costs no credits.
import_asset
ChatGPTCopy 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_brand_profile
ChatGPTRead 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.
list_ad_formats
ChatGPTSee 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_brand_profiles
ChatGPTList 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_canvases
ChatGPTList 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_dramas
ChatGPTList 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_generations
ChatGPTList the account's recent video generations, newest first, with their status and URLs.
list_models
ChatGPTSee 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_saved_ads
ChatGPTList 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_ugc_avatars
ChatGPTSee 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_video_agent_runs
ChatGPTList 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.
message_video_agent
ChatGPTSend 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.
move_cards
ChatGPTMove 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.
produce_drama_episode
ChatGPTRender 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.
quote_drama_episode
ChatGPTPrice 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.
refresh_canvas
ChatGPTRe-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.
rename_canvas
ChatGPTRename a board. Costs no credits.
review_drama_draft
ChatGPTAccept 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.
revise_drama
ChatGPTAsk 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.
run_generation_card
ChatGPTRender 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.
save_competitor_ad
ChatGPTKeep 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.
search_articles
ChatGPTSearch AI Content Drop's published guides and model comparisons about AI video generation, prompting, and ad creative.
search_competitor_ads
ChatGPTSearch live competitor ads by keyword on Meta or TikTok: advertiser, copy, hook, call to action, media and run time per ad. Costs no credits. When live data is not available the rows are samples, marked demo: true with a note; never present those as real ads.
start_drama
ChatGPTStart a short drama from a premise and have it written: cast, locations, and every episode's scenes with beats and dialogue. Returns at once; the draft lands in 3 to 5 minutes as pending_draft on get_drama. Writing costs a few credits, charged only when the draft lands; rendering clips is priced separately later.
start_video_agent
ChatGPTOpen a drop: one piece of work that can carry a brief from research through concepts, a plan, generation and assembly. Give it the goal in a sentence. Starting one only opens it and costs no credits: nothing is planned until you send the brief with message_video_agent on its run_id, which begins the planning. The drop may ask clarifying questions before it plans, and every step that would charge credits waits for approve_video_agent_spend.
update_card
ChatGPTChange a card: merge fields into its data (text or title on a text card; prompt, model, kind, aspect_ratio, duration, resolution or image_url on a generation card; title or caption on a media card; label on a frame), or move and resize it. Costs no credits. status, job_id, job_kind, quote_id, media_url, thumbnail_url, credits_used and error are set by the server when a card runs and are refused here. A per-second model is priced from the card's duration and resolution, so set them before quoting.
write_ad_storyboard
ChatGPTTurn an ad brief into a storyboard: 1-5 shots with framing, the spoken line, the caption and the duration of each. Costs no credits. Show it to the person, edit it if needed, then price it with estimate_ad_cost and submit it with generate_ad.
