com.pagetovid/pagetovid

Est-ce que com.pagetovid/pagetovid est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.pagetovid/pagetovid » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 82 outils

• add_comment≈ 339 tokens

  [Free] Adds a timestamped comment; open comments feed the editor's AI revision.

  Paramètres, retour & exemple (4)

  Paramètres

  • at_s · number · optionnel
    Moment in the film, seconds.
  • text · string · requis
    The comment.
  • scene_id · string · optionnel
    From get_storyboard.
  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "add_comment", "arguments": {"text": "texte", "video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"comment": {}}}

• approve≈ 284 tokens

  [Free] Approves the pending round, as one of its approvers.

  Paramètres, retour & exemple (2)

  Paramètres

  • comment · string · optionnel
    Optional note.
  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "approve", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"approval": {}}}

• cancel_video≈ 289 tokens

  [Free] Stops a running render and refunds its render credit and any AI visual still in flight; AI visuals already made stay (reused free). Use it when get_storyboard shows a plan you do not want. A finished render cannot be cancelled. The video is marked cancelled at once; the worker stops at its next step.

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The running video to stop.

  Exemple d'appel

  {"name": "cancel_video", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"was": "texte", "video_id": "texte", "cancelled": true, "credits_refunded": true}}

• copy_scene≈ 451 tokens

  [Free] Copies a scene into another of your videos with its footage and generated media, so nothing is filmed or generated again. A recording cannot change aspect, nor go into a film made from data. Does not re-render.

  Paramètres, retour & exemple (4)

  Paramètres

  • scene_id · string · requis
    The scene to copy, from get_storyboard.
  • to_video_id · string · requis
    The video to copy it into (may be the same one).
  • from_video_id · string · requis
    The video the scene is in.
  • after_scene_id · string · optionnel
    Put it after this scene of the target. Omitted: at the end.

  Exemple d'appel

  {"name": "copy_scene", "arguments": {"scene_id": "texte", "to_video_id": "texte", "from_video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"created": {}, "video_id": "texte", "warnings": [], "revision_id": "texte", "with_footage": true, "needs_rerender": true}}

• create_animation≈ 2916 tokens

  [40 credits] From content you hold (figures, notes, story), no URL. You write scenes; each drawn, voiced, captioned (list_motions: 25 visuals, some with kinds; visual "rushie" = 664 designed cards, e.g. data {rushie:{template:"end-card",props:{headline,mark,url,cta}}}). AI clips (paid plans) only if asked: data.generate (+data.clip) per scene, or ai_mode rich (assist: stills), the server picks scenes, writes prompts; dry_run shows ai_plan.added. Returns a receipt; get_video for the full status.

  Paramètres, retour & exemple (39)

  Paramètres

  • look · string · optionnel · clean | bold | editorial | playful | tech | auto
    As create_video.
  • tone · string · optionnel
    As create_video.
  • draft · boolean · optionnel
    As create_video.
  • grade · string · optionnel · none | warm | cool | vivid | mono | vintage | contrast
    As create_video.
  • intro · boolean · optionnel
    Include the branded opening title card.
  • model · string · optionnel
    As create_video.
  • music · string · optionnel
    As create_video.
  • outro · boolean · optionnel
    As create_video.
  • theme · object · optionnel
    As create_video. Omitted: the house palette.
  • title · string · optionnel
    Name for the video. Defaults to the first scene's heading.
  • voice · string · optionnel
    As create_video.
  • scenes · array · requis
    The scenes, in order, 1-20, all validated before anything is charged. On top of the render, a still (data.generate) costs 40 and a clip (data.clip) 311, refunded if it fails.
  • ai_mode · string · optionnel · none | assist | rich
    As create_video. Server picks scenes and prompts; omitted: data.generate only.
  • callout · string · optionnel · none | ring | arrow | underline | dim
    As create_video.
  • dry_run · boolean · optionnel
    Quote only; nothing made or charged.
  • objects · array · optionnel
    With ai_mode: in every added shot.
  • outputs · array · optionnel
    As create_video.
  • cta_text · string · optionnel
    Call to action on the closing card.
  • language · string · optionnel
    As create_video. Write the narration in it.
  • ai_budget · object · optionnel
    A ceiling on this render's AI generation; the receipt's ai_plan says what was asked for and its cost. Omitted: uncapped.
  • character · string · optionnel
    With ai_mode: in every added shot.
  • sfx_level · string · optionnel · off | subtle | full
    As create_video.
  • subtitles · boolean · optionnel
    As create_video.
  • brand_name · string · optionnel
    Name shown on the intro and outro cards.
  • edit_style · string · optionnel · tiktok_punchy | documentary | corporate | cinematic
    As create_video.
  • end_screen · string · optionnel · cta | qr | social | logo | none
    As create_video.
  • source_url · string · optionnel
    Attribution only; nothing is fetched or filmed.
  • max_credits · integer · optionnel
    Refuse (budget_exceeded + quote) above this.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    16:9 for web and YouTube, 9:16 for Reels/Shorts/TikTok, 1:1 and 4:5 (1080×1350) for feeds.
  • callback_url · string · optionnel
    As create_video.
  • cursor_style · string · optionnel · arrow | hand | dot | none
    As create_video.
  • press_effect · string · optionnel · punch | freeze | slowmo | none
    As create_video.
  • caption_style · string · optionnel · karaoke | bold | boxed | minimal | outline
    As create_video.
  • pronunciations · array · optionnel
    As create_video.
  • target_seconds · integer · optionnel
    A check, not a setting: your words set the length. A script over 15% off is refused before any credit moves, with the words to cut or add. Omitted: the scenes alone must run at least 15 s, the film at most 180 s.
  • generate_motion · boolean · optionnel
    As create_video.
  • idempotency_key · string · optionnel
    As create_video.
  • caption_emphasis · string · optionnel · manual | auto | none
    As create_video.
  • caption_animation · string · optionnel · none | pop | bounce | wave | glow | slide
    As create_video.

  Exemple d'appel

  {"name": "create_animation", "arguments": {"scenes": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"draft": true, "error": "texte", "notes": [], "quote": {}, "status": "draft", "ai_plan": {}, "dry_run": true, "formats": [], "upgrade": {}, "page_url": "texte", "progress": 1, "video_id": "texte"}}

• create_character≈ 617 tokens

  [Free or 40 credits] Names a character so generated clips that name it keep one identity. refs (1 to 3 image URLs on this account) is free; a generate prompt DRAWS the reference (paid plans, refunded on failure). Then an image scene's data.clip=true and data.character="<name>". From one of your films take raw_frame_url, never thumbnail_url: its burnt-in text teaches the generator to draw text.

  Paramètres, retour & exemple (5)

  Paramètres

  • name · string · requis
    The character's name, e.g. "Ada, the founder". A clip scene names it in data.character to stay consistent.
  • refs · array · optionnel
    1 to 3 reference image URLs — media on this account (a generated still, a bank asset, a commons asset from list_commons_assets). These become Veo's ingredients so the same character recurs. Give these OR a generate prompt.
  • generate · string · optionnel
    Draw the reference portrait instead of supplying one — e.g. "a woman in her late twenties, platinum blonde, grey tee". Paid plans: 40 credits (one still), refunded if it fails. Ignored when refs are given.
  • site_url · string · optionnel
    Scope the character to one site.
  • description · string · optionnel
    A short line describing the character, added to every clip's prompt so words and image agree.

  Exemple d'appel

  {"name": "create_character", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"character": {}, "credits_charged": 1}}

• create_format≈ 1790 tokens

  [Free] A format is how an episode is made — aspect, language, voice, music, tone, goal, length, cards, brand, theme, the brief or the scene templates — and knows nothing about any subject. It is versioned: update_format writes a new version, shows pin one or follow latest, and every episode records the version that made it. Validated now against a sample item; nothing is rendered.

  Paramètres, retour & exemple (20)

  Paramètres

  • goal · string · optionnel · explainer | ad | demo | tutorial | article
    What the video is for; shapes the script.
  • kind · string · optionnel · video | animation
    video: episodes film the item's page. animation: episodes are drawn from `scenes` with the item's data filled in.
  • name · string · requis
    The format's name, e.g. "Le mot du chantier". Available as {{show}} in templates.
  • tone · string · optionnel
    Delivery of the narration, up to 80 characters — e.g. energetic, calm, authoritative, or a short direction like "dry and deadpan, like a friend telling a story".
  • intro · boolean · optionnel
    Include the branded opening title card.
  • music · string · optionnel
    Music bed, "none", or "asset:<id>" (upload_asset). auto fits the goal and differs from the site's previous films.
  • outro · boolean · optionnel
    Include the closing call-to-action card.
  • theme · object · optionnel
    As create_video.
  • voice · string · optionnel · auto | Kore | Zephyr | Puck | Charon | Aoede | Fenrir | Leda
    Narrator (all multilingual). auto picks a voice that fits the goal and tone and differs from the site's previous films.
  • scenes · array · optionnel
    animation formats: the scene templates, as create_animation's scenes (not from_library), with the placeholders in any string.
  • routing · object · optionnel
    How episodes are made: {planner?: flash|pro, footage?: prefer-recorded|record-fresh}. flash is the benched default (it beat every larger model under the real prompt); pro is a deliberate choice. prefer-recorded uses the site's banked flow recordings when they match a scene; record-fresh films every episode anew, for a subject that changes each time.
  • language · string · optionnel · en | fr | es | de | it | pt | nl | ar
    Language of the voiceover and captions. Write the narration in this language.
  • site_url · string · requis
    Any public http(s) URL on the site the format belongs to; the site is identified by its domain.
  • programme · object · optionnel
    animation formats: the programme instead of plain scenes. {beats: [...], resolvers: [...], computed: {...}, requires_beats: [...], reject_if: [...]}. A beat is a scene (visual, motion, mood, heading, caption, narration, data) plus beat (one of cold_open, title, identity, context, trend, breakdown, outlier, comparison, caveats, verdict, sources), when (an expression; dropped when not true) and for_each (an expression yielding a list; repeated per element). Any string may carry {{ expressions }} — dotted paths and filters such as money(EUR,M), percent(0), say, sort_by(year), take_last(6), map({label: year, value: total}) — and any field may be {"$bind": "expression"} to receive a real number, list or object (a chart's points). Resolvers fetch data before compiling: {id, call: {mcp: alias, tool, input} | {http: url, query, body}, select, required, on_missing: skip_episode | drop_beats(a,b) | use_default | fail_loud, cache: "30d"}; each reads what the ones before it bound. Every numeral in a narration or caption must come from an expression: a figure typed by hand fails validation by beat. validate_format checks the template; preview_episode runs the resolvers and compiles a real episode for free.
  • subtitles · boolean · optionnel
    Burn captions into the picture and emit a .vtt sidecar.
  • brand_name · string · optionnel
    Name shown on the intro and outro cards.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    16:9 for web and YouTube, 9:16 for Reels/Shorts/TikTok, 1:1 and 4:5 (1080×1350) for feeds.
  • focus_template · string · optionnel
    video formats: the brief every episode's script writer gets, with {{title}} {{summary}} {{link}} {{date}} {{image}} {{show}} {{site}} filled from the item.
  • target_seconds · integer · optionnel
    A check, not a setting: your words set the length. A script over 15% off is refused before any credit moves, with the words to cut or add. Omitted: the scenes alone must run at least 15 s, the film at most 180 s.
  • title_template · string · optionnel
    animation formats: the episode's title, same placeholders. Default "{{show}} — {{title}}".

  Exemple d'appel

  {"name": "create_format", "arguments": {"name": "texte", "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"format": {}, "next_step": "texte"}}

• create_motion≈ 530 tokens

  [Paid plans] Designs a custom motion graphic from a brief (one text-model call; AI plans or a film pass; no credits charged), checks layout, legibility, contrast and timing, and saves it as a private template with params. Use it in a scene: visual "motion", data {motion:{specId, params}}.

  Paramètres, retour & exemple (5)

  Paramètres

  • name · string · optionnel
    A name for the template.
  • tags · array · optionnel
    Labels to find it by.
  • brief · string · requis
    What the scene shows and says, with its facts and figures.
  • language · string · optionnel
    On-screen language (default en).
  • site_url · string · optionnel
    Use this site's brand kit colours.

  Exemple d'appel

  {"name": "create_motion", "arguments": {"brief": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"tokens": 1, "attempts": 1, "template": {}, "warnings": []}}

• create_object≈ 680 tokens

  [Free] Names a product, logo, packaging, place, vehicle or UI screen from reference images so films keep it identical. Generated pictures take it in data.objects (clips, stills, insets, generate_asset) next to a character; image, gallery, pricing and compare cards draw it from data.object with its name and price.

  Paramètres, retour & exemple (7)

  Paramètres

  • kind · string · requis · product | bag | watch | logo | packaging | place | vehicle | ui_screen
    What it is.
  • name · string · requis
    The object's name, e.g. "Aurora watch". Scenes name it.
  • refs · array · requis
    1-6 reference images, best first: asset ids (list_assets) or media URLs on this account.
  • metadata · object · optionnel
    {price, currency (ISO 4217), brand, sku, url}. A price is drawn on pricing/compare/image cards.
  • site_url · string · optionnel
    Scope it to one of your sites.
  • source_url · string · optionnel
    Where it comes from (a product page). Attribution only.
  • description · string|null · optionnel
    One line added to every prompt that names it.

  Exemple d'appel

  {"name": "create_object", "arguments": {"kind": "product", "name": "texte", "refs": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"object": {}, "replaced": true}}

• create_review_link≈ 266 tokens

  [Free] A link to watch the film and, if allowed, comment with no account. Shown once; only its hash is stored.

  Paramètres, retour & exemple (3)

  Paramètres

  • video_id · string · requis
    The video's id.
  • can_comment · boolean · optionnel
    Guests may comment.
  • expires_in_hours · integer · optionnel
    Lifetime.

  Exemple d'appel

  {"name": "create_review_link", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"expires_at": "texte", "review_url": "texte"}}

• create_show≈ 2037 tokens

  [Free] A show makes a video from each new item in a feed: a weekly release video from a changelog, a daily listing video from an RSS feed, a clip per new post. Episodes are ordinary videos made by run_show or, once confirmed, by the scheduler at the show's cadence. A new show is HELD: nothing renders until its owner has called run_show once with confirm=true, and it never spends more than max_credits_per_day.

  Paramètres, retour & exemple (30)

  Paramètres

  • goal · string · optionnel · explainer | ad | demo | tutorial | article
    As create_format.
  • kind · string · optionnel · video | animation
    video: each episode films the item's own page (like create_video) with focus_template as its brief. animation: each episode is drawn from `scenes` (like create_animation) with the item's data filled in.
  • name · string · requis
    The show's name, e.g. "Le mot du chantier". Available as {{show}} in templates.
  • tone · string · optionnel
    As create_format.
  • intro · boolean · optionnel
    As create_format.
  • music · string · optionnel
    As create_format.
  • outro · boolean · optionnel
    As create_format.
  • theme · object · optionnel
    As create_video.
  • voice · string · optionnel
    As create_format.
  • scenes · array · optionnel
    As create_format. An image scene whose {{image}} is empty for an item is dropped from that episode.
  • source · object · optionnel
    feed_kind query: {call: {mcp: alias, tool, input} | {http: url, query}, select: an expression into the answer that yields the list, map: dotted paths from an element to the item ({id, title, summary, link, image, date})}. Strings in the input may carry {{ show }}, {{ site }} and {{ now }}. Called once now to make sure it answers.
  • cadence · string · optionnel · manual | hourly | daily | weekly
    How often the scheduler runs the show once it is confirmed. manual: only when run_show is called. Default daily; manual for manual and webhook feeds.
  • routing · object · optionnel
    As create_format.
  • feed_map · object · optionnel
    For feed_kind json when the document is not a JSON Feed: dotted paths, e.g. {"items":"data.results","id":"slug","title":"name","summary":"excerpt","link":"href","image":"cover.url","date":"published_at"}. `items` may be omitted when the document is an array.
  • feed_url · string · optionnel
    The feed's public URL for rss and json. It is read once now to make sure it parses.
  • language · string · optionnel
    As create_format.
  • site_url · string · requis
    Any public http(s) URL on the site; the site is identified by its domain.
  • feed_kind · string · optionnel · rss | json | manual | query | watchlist | webhook
    rss: RSS/Atom. json: a JSON Feed or any JSON API via feed_map. query: one call per run on a registered connection (`source`). watchlist: the fixed items in `watchlist`. webhook: another system POSTs items to the show's webhook URL, signed with the secret returned once (X-PageToVid-Signature: sha256=HMAC of the body); cadence manual. manual: items passed to run_show, never scheduled.
  • format_id · string · optionnel
    Run an existing format (create_format / list_formats) instead of the fields below; its kind must match. Without it, the fields below become the show's own format, version 1, editable later with update_format.
  • subtitles · boolean · optionnel
    As create_format.
  • watchlist · array · optionnel
    feed_kind watchlist: the items, as run_show takes them. Each is made once — or once per period with repeat_every.
  • brand_name · string · optionnel
    As create_format.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    As create_format.
  • repeat_every · string · optionnel · none | month | quarter | year
    query and watchlist shows: make every item again each period (the period is in the episode key and available to a programme as {{ item.period }}). none: each item once, ever.
  • focus_template · string · optionnel
    As create_format. Omitted: a brief leading with the item's title and summary.
  • format_version · integer · optionnel
    With format_id: pin the show to this version. Omitted, the show follows the format's latest version.
  • target_seconds · integer · optionnel
    As create_format.
  • title_template · string · optionnel
    As create_format.
  • max_credits_per_day · integer · optionnel
    The show never spends more than this in a UTC day, however many items the feed gains. An episode is 40 credits.
  • max_episodes_per_run · integer · optionnel
    Newest items first; at most this many episodes per run.

  Exemple d'appel

  {"name": "create_show", "arguments": {"name": "texte", "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"held": true, "show": {}, "next_step": "texte", "webhook_secret": "texte"}}

• create_upload≈ 307 tokens

  [Free] A one-hour address to send a file you hold (picture, clip, music, font, PDF/PPTX deck, ≤ 30 MB): curl -sS -T <file> "<upload_url>". The reply is the asset or the deck's slides.

  Paramètres, retour & exemple (3)

  Paramètres

  • kind · string · optionnel · image | video | audio | font | deck
    Read from the bytes if omitted.
  • name · string · optionnel
    A label.
  • site_url · string · optionnel
    Attach to this site.

  Exemple d'appel

  {"name": "create_upload", "arguments": {"kind": "image", "name": "texte", "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"curl": "texte", "method": "texte", "max_bytes": 1, "expires_at": "texte", "upload_url": "texte"}}

• create_video≈ 3049 tokens

  [40 credits] [paid plans: + 40 per AI still unless ai_mode none; dry_run quotes] Turns a public web page into a narrated video: AI voiceover, motion graphics, optional subtitles. Asynchronous (minutes, sometimes past fifteen): returns a receipt with the video_id at once; get_video for the full status. A page behind a login is filmed only with a capture session from the VS Code or browser extension (Scale plan and up).

  Paramètres, retour & exemple (39)

  Paramètres

  • url · string · requis
    Public http(s) page to film; you must have the right to.
  • goal · string · optionnel · explainer | ad | demo | tutorial | article
    What the video is for; shapes the script.
  • look · string · optionnel · clean | bold | editorial | playful | tech | auto
    The film's look: captions, cutting, sound cues, music family and motion together; auto varies with goal, shape and the site's films (list_video_options).
  • tone · string · optionnel
    Narration delivery, e.g. calm, or a short direction.
  • draft · boolean · optionnel
    Free preview: 1/3 resolution, DRAFT mark, no AI visuals. 5/hour. rerender_video without draft then makes the paid film, no re-plan.
  • focus · string · optionnel
    Context the page cannot show (an offer, the audience, a code, what to avoid). Anything here may be voiced as FACT in the customer's voice; a line in quotation marks is placed verbatim, usually as the hook.
  • grade · string · optionnel · none | warm | cool | vivid | mono | vintage | contrast
    Footage colour grade; overrides the look's.
  • intro · boolean · optionnel
    Opening title card (1.5 s). Omitted: true, except goal "ad" (opens on its hook).
  • model · string · optionnel
    Clip model (list_models) for ai_mode rich, or auto (routed per scene, see optimize); omit for the house clip.
  • music · string · optionnel
    Music bed, "none", or "asset:<id>" (upload_asset). auto fits the goal and differs from the site's previous films.
  • outro · boolean · optionnel
    Closing call-to-action card.
  • theme · object · optionnel
    Palette, type and mode; list_themes has the presets and rules, detect_brand reads a site's. Omitted: a filmed video adopts the page's CSS.
  • voice · string · optionnel · auto | Kore | Zephyr | Puck | Charon | Aoede | Fenrir | Leda
    Narrator (all multilingual). auto picks a voice that fits the goal and tone and differs from the site's previous films.
  • ai_mode · string · optionnel · none | assist | rich
    AI visuals for beats the page cannot show (paid plans): none; assist = a few stills; rich = stills and clips within ai_budget. Omitted: assist where the plan generates, else none. Charged per visual, refunded on failure.
  • callout · string · optionnel · none | ring | arrow | underline | dim
    What points at a screencast's subject.
  • dry_run · boolean · optionnel
    Quote only; nothing made or charged.
  • outputs · array · optionnel
    One storyboard in 1-4 shapes: the first is this video (replaces aspect_ratio), each other a sibling (get_video formats), a render each, started when the first ends.
  • routing · object · optionnel
    {planner?: flash|pro, footage?: prefer-recorded|record-fresh}. flash is the benched default (pro is a choice, not an upgrade); prefer-recorded reuses the site's banked flow recordings.
  • language · string · optionnel · en | fr | es | de | it | pt | nl | ar
    Language of the script and voiceover.
  • optimize · string · optionnel · quality | balanced | speed | cost
    With model auto: quality, balanced (default), speed or cost.
  • ai_budget · object · optionnel
    Ceiling on AI visuals, given to the planner.
  • sfx_level · string · optionnel · off | subtle | full
    Sound-design loudness; overrides the look's.
  • subtitles · boolean · optionnel
    Burn captions in and emit a .vtt sidecar.
  • brand_name · string · optionnel
    Name on the intro and outro cards; default the site's.
  • edit_style · string · optionnel · tiktok_punchy | documentary | corporate | cinematic
    Cutting rhythm (list_motions); a scene's own transition still wins.
  • end_screen · string · optionnel · cta | qr | social | logo | none
    The closing card.
  • max_credits · integer · optionnel
    Refuse (budget_exceeded + quote) above this.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    9:16 (Reels/Shorts) films the page's MOBILE layout in a phone viewport; 16:9, 1:1 and 4:5 film the 1280-wide desktop layout.
  • callback_url · string · optionnel
    https URL POSTed a JSON event when the render ends (done/held/error/cancelled), 3 tries. Verify: X-PageToVid-Signature = "sha256=" + hex HMAC-SHA256(secret, X-PageToVid-Timestamp + "." + raw body); refuse timestamps over 5 min old. Secret: webhook_secret, shown once, or rotate_webhook_secret.
  • cursor_style · string · optionnel · arrow | hand | dot | none
    The pointer a recording draws.
  • press_effect · string · optionnel · punch | freeze | slowmo | none
    What the picture does on a click.
  • quality_gate · object · optionnel
    auto_fix (default): dead air and colliding overlays fixed before rendering (auto_fixes). hold: also, a film scored under min_score ends "held" until release_video. deliver: as authored.
  • caption_style · string · optionnel · karaoke | bold | boxed | minimal | outline
    Overrides the look's captions.
  • pronunciations · array · optionnel
    Voice-only lexicon, e.g. [{"text":"Nginx","say":"engine x"}]; captions keep the text.
  • target_seconds · integer · optionnel
    Length asked for: the words are written to fit it.
  • generate_motion · boolean · optionnel
    Custom motion graphics for beats no built-in visual fits (AI plans or a film pass, else built-in).
  • idempotency_key · string · optionnel
    Same key within 24 h returns the original video, uncharged. Without one, an identical call within 120 s returns the first video (idempotent_replay).
  • caption_emphasis · string · optionnel · manual | auto | none
    Brand-coloured words: **asterisked** (manual), plus figures (auto), or none.
  • caption_animation · string · optionnel · none | pop | bounce | wave | glow | slide
    What a spoken word does; overrides the look's.

  Exemple d'appel

  {"name": "create_video", "arguments": {"url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"draft": true, "error": "texte", "notes": [], "quote": {}, "status": "draft", "ai_mode": "texte", "dry_run": true, "formats": [], "upgrade": {}, "estimate": {}, "page_url": "texte", "progress": 1}}

• delete_character≈ 211 tokens

  [Free] Deletes a character by name. Its reference images stay in your bank and clips made with it stay in their films.

  Paramètres, retour & exemple (1)

  Paramètres

  • name · string · requis
    The character's current name.

  Exemple d'appel

  {"name": "delete_character", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"name": "texte", "deleted": true}}

• delete_object≈ 204 tokens

  [Free] Deletes an object by name. Its images stay in your bank and media made with it stays in its films.

  Paramètres, retour & exemple (1)

  Paramètres

  • name · string · requis
    The object to delete.

  Exemple d'appel

  {"name": "delete_object", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"name": "texte", "deleted": true}}

• detect_brand≈ 410 tokens

  [Free] Reads a public page's design tokens from its live CSS: accent colours, heading typeface, light or dark ground, corner style. Returns a theme ready for create_video, create_animation or rerender_video, plus any site colour the film cannot paint with and why.

  Paramètres, retour & exemple (1)

  Paramètres

  • url · string · requis
    A public page of the site. A heavy home page can time out (read_failed); then try a content page.

  Exemple d'appel

  {"name": "detect_brand", "arguments": {"url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"url": "texte", "theme": {}, "title": "texte", "domain": "texte", "read_failed": true, "font_loadable": true, "rejected_colors": [], "read_failed_reason": "texte", "detected_font_family": "texte"}}

• fork_format≈ 526 tokens

  [Free] A new format whose version 1 is the original's latest version, unpinned from its parent. Edit the copy without touching the original.

  Paramètres, retour & exemple (3)

  Paramètres

  • name · string · optionnel
    The copy's name. Default: the original's name with " (copy)".
  • site_url · string · optionnel
    The site the copy belongs to. Default: the original's site.
  • format_id · string · requis
    The format_id from create_format or list_formats.

  Exemple d'appel

  {"name": "fork_format", "arguments": {"format_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"format": {}}}

• generate_asset≈ 1406 tokens

  [40 or 311 credits] One AI still (40 credits each) or clip (house 311, a named model its list_models price) straight into your bank — no render. Clip controls are refused, with the allowed values, when the model is not sent them; model auto picks one and says why. best_of makes N and keeps the best graded (all N charged). Charged before, refunded on failure; dry_run quotes it free. Paid plans.

  Paramètres, retour & exemple (22)

  Paramètres

  • kind · string · optionnel · image | video
    image (a still) or video (a clip). Default image.
  • seed · integer · optionnel
    Where the model takes one.
  • shot · string · optionnel · wide | medium | close_up
    Folded into the prompt.
  • tags · string · optionnel
    Comma-separated tags, to find it again.
  • count · integer · optionnel
    Stills: how many, each charged.
  • model · string · optionnel
    list_models id, house, house-image, or auto (clips; see optimize).
  • camera · object · optionnel
    Folded into the prompt.
  • prompt · string · requis
    What to draw or film.
  • best_of · integer · optionnel
    N graded, best kept, all charged.
  • dry_run · boolean · optionnel
    Quote only; nothing made or charged.
  • objects · array · optionnel
    Object names (list_objects) kept consistent, after the character.
  • optimize · string · optionnel · quality | balanced | speed | cost
    For model auto. Default balanced.
  • site_url · string · optionnel
    Attach it to one of your sites.
  • character · string · optionnel
    A character from create_character, so the same face comes back.
  • duration_s · integer · optionnel
    Seconds (list_models range).
  • last_frame · string · optionnel
    Bank image to end on.
  • resolution · string · optionnel · 480p | 720p | 768p | 1080p | 2k | 4k
    One the model offers.
  • first_frame · string · optionnel
    Bank image id/URL to start on.
  • max_credits · integer · optionnel
    Refuse (budget_exceeded + quote) above this.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5 | 21:9
    Default 16:9. 21:9 and 4:5 only where list_models says the model takes them.
  • idempotency_key · string · optionnel
    Same key within 24 h returns what it made, uncharged. Without one, an identical call within 10 min does; one still running is reported, not restarted.
  • negative_prompt · string · optionnel
    Where the model takes one.

  Exemple d'appel

  {"name": "generate_asset", "arguments": {"prompt": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"asset": {}, "model": "texte", "quote": {}, "assets": [], "dry_run": true, "warnings": [], "candidates": [], "model_reason": "texte", "credits_charged": 1, "idempotent_replay": true}}

• generate_site_videos≈ 1087 tokens

  [40 credits] Per video started. One filmed video per get_site_plan idea without one (or the idea_ids given), of its verified page with its sourced brief as focus. Without confirm it lists what it would make and the cost, capped at the balance (the rest under needs_credits), creating nothing; confirm=true starts those. get_video reports each. A retry never starts an idea twice.

  Paramètres, retour & exemple (16)

  Paramètres

  • url · string · optionnel
    The page to film for every video. Omitted, each idea films its own verified page (page_url in get_site_plan).
  • look · string · optionnel · clean | bold | editorial | playful | tech | auto
    As create_video.
  • intro · boolean · optionnel
    Include the branded opening title card.
  • music · string · optionnel
    As create_video.
  • outro · boolean · optionnel
    As create_video.
  • theme · object · optionnel
    As create_video.
  • voice · string · optionnel
    As create_video.
  • confirm · boolean · optionnel
    false (the default) previews the videos and spends nothing. true starts them and spends 40 credits each.
  • idea_ids · array · optionnel
    Which ideas from get_site_plan to make, in order. Omitted: every idea that has no video yet.
  • language · string · optionnel
    As create_video.
  • site_url · string · requis
    Any public http(s) URL on the site; the site is identified by its domain.
  • subtitles · boolean · optionnel
    As create_video.
  • brand_name · string · optionnel
    Name shown on the intro and outro cards.
  • max_videos · integer · optionnel
    At most this many videos in one call. Call again for the rest.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    As create_video.
  • caption_style · string · optionnel · karaoke | bold | boxed | minimal | outline
    As create_video.

  Exemple d'appel

  {"name": "generate_site_videos", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"site": "texte", "skipped": [], "started": [], "next_step": "texte", "would_make": [], "needs_credits": [], "credits_needed": 1, "credits_charged": 1, "credits_available": 1, "needs_confirmation": true}}

• get_account≈ 656 tokens

  [Free] Reads this account. CALL THIS FIRST: plan, credits, whether AI visuals are available and charged, watermark, revisions, film passes, add-on clips, renders running, limits. Then: inspect_page (in the aspect you will film), create_video or create_animation, get_storyboard (the chosen shots), update_storyboard, rerender_video.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_account", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"plan": "texte", "limits": {}, "credits": 1, "webhook": {}, "revisions": "plan", "film_passes": [], "pricing_url": "texte", "upgrade_url": "texte", "watermarked": true, "capabilities": {}, "credit_costs": {}, "clip_balances": {}}}

• get_audit_log≈ 290 tokens

  [Free] Who did what here, newest first: members, spending, review links, approvals, comments.

  Paramètres, retour & exemple (2)

  Paramètres

  • since · string · optionnel
    Only entries from this time on.
  • site_url · string · optionnel
    Only entries about this site.

  Exemple d'appel

  {"name": "get_audit_log", "arguments": {"since": "texte", "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"entries": []}}

• get_brand_kit≈ 465 tokens

  [Free] A site's brand kit, what a film paints from it (and what it cannot, with why), the effective watermark, and the account defaults beneath it.

  Paramètres, retour & exemple (1)

  Paramètres

  • site_url · string · requis
    Any URL of the site.

  Exemple d'appel

  {"name": "get_brand_kit", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"kit": {}, "domain": "texte", "exists": true, "painted": [], "detected": true, "font_url": "texte", "logo_url": "texte", "film_theme": "texte", "not_painted": [], "watermark_from": "texte", "account_defaults": "texte", "watermark_effective": true}}

• get_format≈ 453 tokens

  [Free] The format's current template, its version history and the shows that run it, with each show's pin.

  Paramètres, retour & exemple (1)

  Paramètres

  • format_id · string · requis
    The format_id from create_format or list_formats.

  Exemple d'appel

  {"name": "get_format", "arguments": {"format_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"format": {}}}

• get_frames≈ 342 tokens

  [Free] JPEG stills (≤ 1280 px wide) cut from the finished MP4 at 1–6 moments in seconds, as URLs. Cached per render.

  Paramètres, retour & exemple (2)

  Paramètres

  • times · array · requis
    1–6 times in seconds (0.1 s steps).
  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "get_frames", "arguments": {"times": [], "video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"frames": [], "video_id": "texte", "max_width": 1, "video_url": "texte"}}

• get_motion_grammar≈ 275 tokens

  [Free] The grammar for writing your own animation as a motion spec: no topic → a short index and the authoring loop; topic → one rule file (layers, params, timing, motion, colour, layout, doctrine, examples, brief). Generated from the DSL itself.

  Paramètres, retour & exemple (1)

  Paramètres

  • topic · string · optionnel · layers | params | timing | motion | colour | layout | doctrine | examples
    One topic; omit for the index.

  Exemple d'appel

  {"name": "get_motion_grammar", "arguments": {"topic": "layers"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"text": "texte", "topic": "texte", "topics": []}}

• get_motion_template≈ 339 tokens

  [Free] One template with its full spec (layers, motion tokens, declared params).

  Paramètres, retour & exemple (1)

  Paramètres

  • template_id · string · requis
    The template's id.

  Exemple d'appel

  {"name": "get_motion_template", "arguments": {"template_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"spec": {}, "template": {}}}

• get_site_plan≈ 970 tokens

  [Free] Up to 5 ranked videos a site should have, one per subject: goal, pitch, the real page it films (checked), the video made; detail full adds the brief, sources and shots. First call generates it (~10-20 s, no credit), then banks the site's images, videos and page clips in the background (media counts them). generate_site_videos works from it.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    How many ideas, best first.
  • detail · string · optionnel · short | full
    short: title, goal, pitch, page and whether it was made. full: also the brief (focus), its sources, audience, tone and shots.
  • refresh · boolean · optionnel
    true regenerates the plan even if one exists, overwriting it. A plan is generated automatically the first time.
  • language · string · optionnel · en | fr | es | de | it | pt | nl | ar
    Language the ideas and shot list are written in. This is the planner's working language, not the videos' — generate_site_videos sets that.
  • site_url · string · requis
    Any public http(s) URL on the site; the site is identified by its domain.

  Exemple d'appel

  {"name": "get_site_plan", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"site": "texte", "ideas": [], "media": {}, "detail": "texte", "site_url": "texte", "next_step": "texte", "made_count": 1, "total_ideas": 1, "generated_at": "texte", "to_make_count": 1, "grounding_notes": [], "freshly_generated": true}}

• get_storyboard≈ 1498 tokens

  [Free] Reads this account. Returns the scene-by-scene plan of a video: what each scene narrates, its on-screen caption, how long it holds, and whether it is real footage of the page or a motion graphic (and which motion).

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The video_id to read.

  Exemple d'appel

  {"name": "get_storyboard", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"claims": [], "scenes": [], "totals": {}, "resolved": "texte", "video_id": "texte", "editor_url": "texte", "scene_count": 1, "claims_summary": "texte", "pronunciations": [], "duration_source": "rendered"}}

• get_timeline≈ 478 tokens

  [Free] Each scene's start and end in the finished MP4 (seconds), what drew it (recording, page still, AI clip/still, footage, graphic, card, inset), its transition, its slice of the one voice track with word onsets, plus the music and caption style. timeline_source: stored by the render, or rebuilt from the scenes.

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "get_timeline", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"fps": 1, "music": {}, "scenes": [], "video_id": "texte", "subtitles": true, "caption_style": "texte", "timeline_source": "rendered", "duration_seconds": 1, "film_duration_seconds": 1, "voice_starts_at_seconds": 1}}

• get_video≈ 1593 tokens

  [Free] Reads this account. The full status of a render: phase and progress while it runs (with poll_after_seconds), then the files, length, credits, warnings and quality; on a free film, `upgrade` to relay once. `status` is one of, in pipeline order: draft, queued, analyzing, scripting, recording, voicing, rendering, held, done, error. In flight, so poll again after poll_after_seconds: queued, analyzing, scripting, recording, voicing, rendering. Terminal, so stop polling: held, done, error — a cancelled render ends as error with the reason in `error`, and a film can be done and still carry warnings. held: finished but unpublished by quality_gate. draft has not been queued.

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The video_id returned by create_video.

  Exemple d'appel

  {"name": "get_video", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"goal": "texte", "kind": "texte", "look": "texte", "tone": "texte", "draft": true, "error": "texte", "intro": true, "music": "texte", "outro": true, "style": "texte", "voice": "texte", "width": 1}}

• get_video_embed≈ 464 tokens

  [Free] Returns ready-to-paste markup for a finished PageToVid video: an HTML video element, Open Graph and Twitter player meta tags so the page unfurls as a playable video, and a schema.org VideoObject JSON-LD block.

  Paramètres, retour & exemple (4)

  Paramètres

  • title · string · optionnel
    Overrides the title in the share card. Defaults to the video's own title.
  • page_url · string · optionnel
    The page this markup will be pasted into. Used for og:url so a share resolves to your page rather than nothing.
  • video_id · string · requis
    The video_id of a finished render.
  • description · string · optionnel
    Overrides the share description. Defaults to a sentence written in the video's language.

  Exemple d'appel

  {"name": "get_video_embed", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"html": "texte", "title": "texte", "width": 1, "height": 1, "iframe": "texte", "json_ld": "texte", "video_id": "texte", "embed_url": "texte", "meta_tags": "texte", "description": "texte", "aspect_ratio": "texte"}}

• import_objects≈ 618 tokens

  [Free] Creates or replaces up to 50 objects from a product feed. Each image is downloaded (public addresses only) and banked as a reference. Failed rows are listed with the reason.

  Paramètres, retour & exemple (2)

  Paramètres

  • items · array · requis
    1-50 catalogue rows. image_url: one public image URL or a list (best first, up to 6); kind defaults to product.
  • site_url · string · optionnel
    Scope it to one of your sites.

  Exemple d'appel

  {"name": "import_objects", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"failed": [], "created": []}}

• inspect_page≈ 962 tokens

  [Free] Opens a public page in a real browser and ranks what a video could film — calls to action, images, cards, pricing, testimonials, search boxes, headings — each with a CSS selector, kind, size and score (a rank, not a percentage). Says when a robot check, sign-in or missing page stood in front of it (blocked, block_kind), and which fields will never be typed into.

  Paramètres, retour & exemple (4)

  Paramètres

  • url · string · requis
    A public page to look at. Nothing is filmed and no credit is spent.
  • kinds · string · optionnel
    Comma-separated kinds to keep, e.g. "cta,search,card". The vocabulary is in the `kinds` histogram of any reply: cta, media, image, card, pricing, testimonial, logos, heading, section, nav, search, chat, input. Omitted, every kind is offered.
  • limit · integer · optionnel
    How many candidates to return, best first (a page offers up to 40; a film uses four or five). The `kinds` histogram still counts every one.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    The viewport to look through. 9:16 loads the page as a phone does, which is the layout a vertical video films — a responsive site offers different elements there (a sticky call bar, stacked cards) and they score differently.

  Exemple d'appel

  {"name": "inspect_page", "arguments": {"url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"url": "texte", "kinds": {}, "pages": [], "title": "texte", "device": "texte", "layout": "texte", "blocked": true, "viewport": {}, "block_kind": "texte", "candidates": [], "aspect_ratio": "texte", "block_reason": "texte"}}

• invite_member≈ 462 tokens

  [Free] Emails an invite to this workspace with a role, optional site limits and monthly credit cap. Members spend the owner's credits. Seats incl. owner: Free/Creator 1, Pro 3, Scale 5, Business 15, Agency unlimited.

  Paramètres, retour & exemple (4)

  Paramètres

  • role · string · requis · admin | editor | reviewer | viewer | billing
    editor makes and spends; reviewer comments and approves.
  • email · string · requis
    They join by signing in with it.
  • site_urls · array|null · optionnel
    Limit to these sites; null = all.
  • credit_cap · integer|null · optionnel
    Monthly credit cap; null = none.

  Exemple d'appel

  {"name": "invite_member", "arguments": {"role": "admin", "email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"member": {}, "email_sent": true}}

• list_assets≈ 458 tokens

  [Free] Your PRIVATE bank: every image, clip and audio file, by origin and subject, with id, URL, brief, tags and facets. Reuse a picture by putting its id in an image scene as data.asset_id (a clip resolves to clipUrl by itself); an audio asset is a film's music as "asset:<id>". Reusing costs no credit.

  Paramètres, retour & exemple (5)

  Paramètres

  • q · string · optionnel
    Words, and/or facets origin: subject: camera: light: look: mood: orientation:
  • kind · string · optionnel · image | video | audio | font
    Only images, clips, uploaded audio or fonts.
  • limit · integer · optionnel
    At most this many, newest first (default 40).
  • site_url · string · optionnel
    Only assets attached to this site.
  • character · string · optionnel
    Only assets generated for this character.

  Exemple d'appel

  {"name": "list_assets", "arguments": {"q": "texte", "kind": "image", "limit": 1, "site_url": "texte", "character": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"assets": []}}

• list_characters≈ 260 tokens

  [Free] The reusable characters on this account, each with its reference images and description.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_characters", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"characters": []}}

• list_comments≈ 381 tokens

  [Free] Timestamped comments from members and review-link guests, oldest first, and the approval round.

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "list_comments", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"approval": "texte", "comments": []}}

• list_commons_assets≈ 454 tokens

  [Free] Media people shared from their banks for anyone's films — logos, product shots, illustrations, recorded flows — with tags, a licence and the site to credit. An image scene takes an asset's id as data.asset_id (or its url as imageUrl); a gallery takes urls. Only assets their owners switched to shared.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · optionnel
    A word to find in tags or the asset's brief.
  • tag · string · optionnel
    One tag, e.g. logo, dashboard, person.
  • kind · string · optionnel · image | video
    Only images, or only clips.
  • limit · integer · optionnel
    At most this many, newest first (default 40).

  Exemple d'appel

  {"name": "list_commons_assets", "arguments": {"q": "texte", "tag": "texte", "kind": "image", "limit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"assets": [], "commons_url": "texte"}}

• list_connections≈ 270 tokens

  [Free] Every registered connection with its alias, kind and URL. Credentials are never returned.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_connections", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"connections": []}}

• list_formats≈ 458 tokens

  [Free] The account's formats, newest change first, with versions and the shows running each.

  Paramètres, retour & exemple (1)

  Paramètres

  • site_url · string · optionnel
    Only this site's formats. Omitted, every format on the account.

  Exemple d'appel

  {"name": "list_formats", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"formats": [], "total_count": 1}}

• list_members≈ 453 tokens

  [Free] Members with role, sites, cap and spend this month; seats; your workspaces (send one as the X-PageToVid-Workspace header to act in it).

  Paramètres, retour & exemple (1)

  Paramètres

  • site_url · string · optionnel
    Only members with this site.

  Exemple d'appel

  {"name": "list_members", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"members": [], "your_role": "texte", "seats_used": 1, "owner_email": "texte", "workspace_id": "texte", "seats_included": 1, "your_workspaces": []}}

• list_models≈ 544 tokens

  [Free] Every model this account can generate clips and stills with — capabilities, limits and the exact credit price — before spending anything. Omit model in a scene for the house clip; name one (data.model, or set_inset model) to choose it and pay its price. quote_cost prices a specific request.

  Paramètres, retour & exemple (2)

  Paramètres

  • modality · string · optionnel · video | image
    Only video or only image models.
  • include_unavailable · boolean · optionnel
    Also list models this account cannot use now, with the reason.

  Exemple d'appel

  {"name": "list_models", "arguments": {"modality": "video", "include_unavailable": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"models": [], "credit_value_note": "texte"}}

• list_motion_templates≈ 354 tokens

  [Free] Your saved motion graphics (visual "motion") and the commons, with their params. Rushie designed cards: list_motions {rushie}.

  Paramètres, retour & exemple (2)

  Paramètres

  • q · string · optionnel
    A word in the name, brief or tags.
  • scope · string · optionnel · all | mine | commons
    Default all.

  Exemple d'appel

  {"name": "list_motion_templates", "arguments": {"q": "texte", "scope": "all"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"templates": []}}

• list_motions≈ 749 tokens

  [Free] How a scene can look: 26 visuals, 817 animations, motions, transitions, fx. Check pairs before writing scenes. New: get_motion_grammar.

  Paramètres, retour & exemple (2)

  Paramètres

  • rushie · string · optionnel
    Search: words, id or beat (+9:16/1:1).
  • for_scene · string · optionnel
    Narration → 5 picks.

  Exemple d'appel

  {"name": "list_motions", "arguments": {"rushie": "texte", "for_scene": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"fx": [], "rule": "texte", "motions": [], "presets": [], "visuals": [], "families": {}, "edit_styles": [], "recommended": [], "transitions": [], "rushie_index": {}, "rushie_summary": {}, "rushie_templates": []}}

• list_objects≈ 406 tokens

  [Free] The reusable objects on this account, with reference images, kind and metadata (price, brand, sku).

  Paramètres, retour & exemple (3)

  Paramètres

  • q · string · optionnel
    A word in the name or description.
  • kind · string · optionnel · product | bag | watch | logo | packaging | place | vehicle | ui_screen
    Only this kind.
  • site_url · string · optionnel
    Scope it to one of your sites.

  Exemple d'appel

  {"name": "list_objects", "arguments": {"q": "texte", "kind": "product", "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"objects": []}}

• list_options≈ 787 tokens

  [Free] Every enum and range a film accepts (voices, languages, beds, looks, captions, motions, transitions, visuals, aspects, faces, brand kit), the models with a credit example, and the inheritance levels.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_options", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"fonts": {}, "goals": [], "looks": [], "music": {}, "grades": [], "models": [], "voices": [], "aspects": [], "motions": {}, "visuals": [], "callouts": [], "brand_kit": {}}}

• list_revisions≈ 338 tokens

  [Free] Every storyboard edit, newest first: what changed and a revision_id. restore_revision puts the storyboard back as it was before one.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    How many, newest first.
  • video_id · string · requis
    The video whose storyboard history to use.

  Exemple d'appel

  {"name": "list_revisions", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"video_id": "texte", "revisions": []}}

• list_scenes≈ 474 tokens

  [Free] Saved scenes, newest first: name, id, visual, aspect, whether footage is kept, the {{placeholders}} each needs as params, and tags.

  Paramètres, retour & exemple (4)

  Paramètres

  • q · string · optionnel
    A word in the name, heading or narration.
  • tags · array · optionnel
    Only scenes carrying every one of these tags.
  • limit · integer · optionnel
    At most this many, newest first (default 40).
  • site_url · string · optionnel
    Scope it to one of your sites.

  Exemple d'appel

  {"name": "list_scenes", "arguments": {"q": "texte", "tags": [], "limit": 1, "site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"scenes": []}}

• list_shows≈ 638 tokens

  [Free] Reads this account. Lists the shows on this account — or one site's — with their cadence, caps, whether each is confirmed or still held, what it spent today, and its five most recent episodes with the video each became.

  Paramètres, retour & exemple (1)

  Paramètres

  • site_url · string · optionnel
    Only this site's shows. Omitted: every show on the account.

  Exemple d'appel

  {"name": "list_shows", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"count": 1, "shows": []}}

• list_themes≈ 426 tokens

  [Free] Lists what the theme parameter accepts: the built-in presets, the modes, the type faces the renderer can load, and the contrast and palette rules enforced before a credit moves. Static reference data.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_themes", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"fonts": {}, "modes": [], "rules": [], "slots": [], "corners": [], "presets": [], "max_colors": 1}}

• list_video_options≈ 487 tokens

  [Free] Lists what create_video accepts: goals, aspect ratios, languages, voices, background music beds (9, each with a family: calm, energetic, serious, playful) and the allowed length range. Static reference data — no account access.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_video_options", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"goals": [], "looks": [], "music": [], "notes": "texte", "voices": [], "devices": [], "languages": [], "aspect_ratios": [], "caption_styles": [], "target_seconds": {}}}

• list_videos≈ 610 tokens

  [Free] Reads this account. Lists videos newest first with their status and, when finished, their links. Filter by status or by a word in the page URL or title. Returns a cursor when more remain.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    How many to return.
  • query · string · optionnel
    Matches part of the source URL or the title.
  • cursor · string · optionnel
    The next_cursor from a previous call. Opaque — pass it back unchanged.
  • status · string · optionnel · any | queued | analyzing | scripting | recording | voicing | rendering | held
    Only videos in this state.
  • created_after · string · optionnel
    ISO 8601 timestamp; only videos created after it.

  Exemple d'appel

  {"name": "list_videos", "arguments": {"limit": 1, "query": "texte", "cursor": "texte", "status": "any", "created_after": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"videos": [], "has_more": true, "next_cursor": "texte", "total_count": 1}}

• list_voices≈ 352 tokens

  [Free] The narrator voices with measured pitch (band and median Hz) and a short sample in the chosen language where one exists (else sample_url is null). Every voice speaks every language.

  Paramètres, retour & exemple (2)

  Paramètres

  • pitch · string · optionnel · low | mid | high
    Only this pitch band.
  • language · string · optionnel · en | fr | es | de | it | pt | nl | ar
    Language of the samples.

  Exemple d'appel

  {"name": "list_voices", "arguments": {"pitch": "low", "language": "en"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"voices": [], "language": "texte", "samples_available": true}}

• preview_episode≈ 542 tokens

  [Free] Runs the format's resolvers against the item (real calls, cached) and compiles the storyboard: every beat's final text, the beats dropped and why, the integrity report and where every bound value came from. Nothing is rendered. Read it before run_show confirm=true.

  Paramètres, retour & exemple (3)

  Paramètres

  • item · object · optionnel
    The item to make the episode of: {title, summary, link, image, date}. Omitted, a sample item.
  • format_id · string · requis
    The format_id from create_format or list_formats.
  • format_version · integer · optionnel
    Preview this version; omitted, the latest.

  Exemple d'appel

  {"name": "preview_episode", "arguments": {"format_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"ok": true, "beats": [], "title": "texte", "report": {}, "dropped": [], "refusal": "texte", "upstream": {}, "provenance": {}}}

• preview_motion≈ 610 tokens

  [Free] Frames back without a render: per aspect (16:9, 9:16, 1:1) a PNG sheet of four beats (entering, landed, hold, exit) — a deterministic LAYOUT wireframe from the DSL's geometry (exact boxes, wrapping, sizes, colours, timing; system font, no blur or shadow) — plus the problems measured on that frame.

  Paramètres, retour & exemple (6)

  Paramètres

  • spec · object · optionnel
    The spec to preview (or template_id).
  • params · object · optionnel
    Param values to check it with (default: the declared defaults).
  • aspects · array · optionnel
    Default all three.
  • seconds · number · optionnel
    The scene's length (its narration slice). Default 5.
  • site_url · string · optionnel
    Lint against this site's brand colours.
  • template_id · string · optionnel
    A saved template to preview instead of a spec.

  Exemple d'appel

  {"name": "preview_motion", "arguments": {"spec": {}, "params": {}, "aspects": [], "seconds": 1, "site_url": "texte", "template_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"ok": true, "note": "texte", "errors": 1, "aspects": [], "preview": "texte", "warnings": 1, "scene_seconds": 1}}

• quote_cost≈ 558 tokens

  [Free] What something will cost, spending nothing: one generation (kind clip or image, optional model, duration_s, resolution, role, count), or a video_id's next rerender_video (render plus every AI visual not yet made). A length between two a model makes is rounded UP, with a warning; one it cannot make is refused with what it can. plan_note says when this plan has no AI generation.

  Paramètres, retour & exemple (7)

  Paramètres

  • kind · string · optionnel · clip | image
    Price one generation of this kind.
  • role · string · optionnel · scene | inset
    A full-frame scene or a presenter in a corner (a presenter uses the cheapest resolution).
  • count · integer · optionnel
    How many, 1-4.
  • model · string · optionnel
    A model id from list_models. Omit for the house model.
  • video_id · string · optionnel
    Price the next rerender_video of this video.
  • duration_s · number · optionnel
    Clip length in seconds, within the model's range.
  • resolution · string · optionnel · 480p | 720p | 768p | 1080p | 2k | 4k
    Clip resolution, one the model offers.

  Exemple d'appel

  {"name": "quote_cost", "arguments": {"kind": "clip", "role": "scene", "count": 1, "model": "texte", "video_id": "texte", "duration_s": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"credits": 1, "warnings": [], "breakdown": [], "plan_note": "texte", "cover_note": "texte"}}

• register_mcp_connection≈ 502 tokens

  [Free] Registers (or replaces) a connection by alias: the URL and, optionally, a credential kept encrypted on this account. Formats refer to the alias only, so a format never carries a secret and is safe to publish or fork. Nothing is called now.

  Paramètres, retour & exemple (5)

  Paramètres

  • url · string · requis
    The server's public http(s) address: an MCP endpoint (streamable HTTP) or an http API base.
  • kind · string · optionnel · mcp | http
    mcp: JSON-RPC tools/call. http: plain JSON endpoints under this base.
  • note · string · optionnel
    What this server is, for the list.
  • alias · string · requis
    The name a format's resolvers use: {"mcp": "finance_ds", ...}. Letters, digits, underscore.
  • secret · string · optionnel
    A bearer token or API key sent as Authorization: Bearer. Stored encrypted, never returned, never in a format.

  Exemple d'appel

  {"name": "register_mcp_connection", "arguments": {"url": "texte", "alias": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"connection": {}}}

• release_video≈ 284 tokens

  [Free] Publishes a video its quality_gate held (status "held") as it is: status becomes done. Nothing is re-rendered.

  Paramètres, retour & exemple (1)

  Paramètres

  • video_id · string · requis
    The held video.

  Exemple d'appel

  {"name": "release_video", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"status": "draft", "page_url": "texte", "video_id": "texte", "video_url": "texte", "permanent_url": "texte"}}

• remove_member≈ 314 tokens

  [Free] Removes a member or cancels an invite, freeing the seat; your own member id leaves the workspace. Their work stays.

  Paramètres, retour & exemple (1)

  Paramètres

  • member_id · string · requis
    From list_members.

  Exemple d'appel

  {"name": "remove_member", "arguments": {"member_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"member": {}}}

• request_approval≈ 311 tokens

  [Free] Opens an approval round for the named approvers; supersedes a pending one.

  Paramètres, retour & exemple (2)

  Paramètres

  • video_id · string · requis
    The video's id.
  • approver_ids · array · requis
    Member ids, or the owner's user id.

  Exemple d'appel

  {"name": "request_approval", "arguments": {"video_id": "texte", "approver_ids": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"approval": {}}}

• request_changes≈ 297 tokens

  [Free] Closes the pending round as changes requested.

  Paramètres, retour & exemple (2)

  Paramètres

  • comment · string · requis
    What to change.
  • video_id · string · requis
    The video's id.

  Exemple d'appel

  {"name": "request_changes", "arguments": {"comment": "texte", "video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"approval": {}}}

• rerender_video≈ 1090 tokens

  [40 credits] [free: captions_only once per paid render; a missed length target once] A new film from the video's current storyboard, without re-planning, plus any AI visual not yet made (quote_cost prices it). Free once per video when the film missed its length target (length_within_tolerance: false). The file is replaced when the new render finishes. Returns a start receipt; call get_video for the full status.

  Paramètres, retour & exemple (11)

  Paramètres

  • draft · boolean · optionnel
    As create_video; only before the first paid render.
  • theme · object · optionnel
    As create_video; replaces the video's theme and is kept for later re-renders.
  • dry_run · boolean · optionnel
    Quote only; nothing made or charged.
  • outputs · array · optionnel
    As create_video; must include this video's shape. Other shapes re-render their sibling or make one, a render each.
  • video_id · string · requis
    The video to re-render.
  • max_credits · integer · optionnel
    Refuse (budget_exceeded + quote) above this.
  • callback_url · string · optionnel
    As create_video, for this render.
  • quality_gate · object · optionnel
    As create_video, for this render.
  • captions_only · boolean · optionnel
    true re-times the subtitles on the existing voice track and renders again; nothing is re-recorded, re-scripted or re-voiced. The first resync after a paid render is free, the next costs a render's credits.
  • target_seconds · integer · optionnel
    What this film should run now, if it has legitimately grown or shrunk since creation. length_within_tolerance is measured against it and later re-renders keep it; their length fit aims at it (words you wrote are retimed, never rewritten).
  • idempotency_key · string · optionnel
    A caller-chosen id for this request. Sending the same key again within 24 hours returns the same re-render instead of starting and charging a second time — use it if your client may retry.

  Exemple d'appel

  {"name": "rerender_video", "arguments": {"video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"draft": true, "error": "texte", "notes": [], "quote": {}, "status": "draft", "dry_run": true, "formats": [], "upgrade": {}, "page_url": "texte", "progress": 1, "video_id": "texte", "warnings": []}}

• restore_revision≈ 314 tokens

  [Free] Puts the storyboard back as it was before a revision, undoing that edit and every later one. Itself a revision, so it can be undone. Nothing is re-rendered until rerender_video.

  Paramètres, retour & exemple (2)

  Paramètres

  • video_id · string · requis
    The video whose storyboard history to use.
  • revision_id · string · requis
    From list_revisions. The storyboard returns to how it was BEFORE this edit.

  Exemple d'appel

  {"name": "restore_revision", "arguments": {"video_id": "texte", "revision_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"video_id": "texte", "scene_count": 1, "undo_revision_id": "texte", "restored_to_before": "texte"}}

• rotate_webhook_secret≈ 218 tokens

  [Free] Replaces the secret completion events are signed with and returns the new one, once. The old secret stops verifying at once, including for retries still in flight.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "rotate_webhook_secret", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"secret_set": true, "webhook_url": "texte", "webhook_secret": "texte"}}

• run_show≈ 797 tokens

  [40 credits] Per episode started. Reads the show's feed (or the items given), skips items already made, and — within max_episodes_per_run and max_credits_per_day — starts one video per new item. Without confirm: the list, nothing spent. On a held show, confirm=true is the owner's one-time approval: it makes the episodes and lets the scheduler run the show from then on.

  Paramètres, retour & exemple (3)

  Paramètres

  • items · array · optionnel
    The items to make episodes from, for a manual show. A feed show ignores this and reads its feed.
  • confirm · boolean · optionnel
    false (the default): a free preview of the episodes this run would make. true: make them, and on a held show, confirm it — from then on the scheduler runs it at its cadence.
  • show_id · string · requis
    The show_id from create_show or list_shows.

  Exemple d'appel

  {"name": "run_show", "arguments": {"show_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"held": true, "reason": "texte", "show_id": "texte", "skipped": [], "started": [], "confirmed": true, "next_step": "texte", "would_make": [], "credits_charged": 1, "credits_left_today": 1, "needs_confirmation": true}}

• save_motion_spec≈ 577 tokens

  [Free] Saves a spec you wrote as a private template once it passes validate_motion_spec (repairs applied). Returns its id, params schema and the scene JSON that uses it: visual "motion", data {motion:{specId, params}}.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
    Default: the spec's name.
  • spec · object · requis
    A motion spec (get_motion_grammar).
  • tags · array · optionnel
    Labels to find it by.
  • params · object · optionnel
    Param values to check it with (default: the declared defaults).
  • site_url · string · optionnel
    Lint against this site's brand colours.
  • visibility · string · optionnel · private | commons
    Default private; commons is owner/admin only.

  Exemple d'appel

  {"name": "save_motion_spec", "arguments": {"spec": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"use": {}, "repairs": [], "template": {}, "warnings": [], "params_schema": []}}

• save_scene≈ 558 tokens

  [Free] Saves a scene for reuse: narration, visual, data, style AND its footage and generated media (a copy). Reusing it — update_storyboard add_scene_from_library, create_animation from_library — films and generates nothing, so no AI credit. Write {{placeholders}} in its narration or data first to fill them per use.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
    A name to reuse it by. The same name replaces the earlier entry.
  • tags · array · optionnel
    Tags to find it by.
  • scene_id · string · requis
    The scene, from get_storyboard.
  • video_id · string · requis
    The video the scene is in.

  Exemple d'appel

  {"name": "save_scene", "arguments": {"name": "texte", "scene_id": "texte", "video_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"scene": {}, "replaced": true, "warnings": []}}

• set_account_defaults≈ 536 tokens

  [Free] Partial update of the options every film starts from (below a site's brand kit). null clears a field.

  Paramètres, retour & exemple (9)

  Paramètres

  • look · string · optionnel · clean | bold | editorial | playful | tech
    Default look.
  • intro · string · optionnel · card | none
    Intro card template.
  • model · string · optionnel
    Clip model for ai_mode rich (list_models).
  • music · string · optionnel
    Default bed, or "asset:<id>".
  • voice · string · optionnel · Kore | Zephyr | Puck | Charon | Aoede | Fenrir | Leda | Orus
    Default narrator.
  • end_screen · string · optionnel · cta | qr | social | logo | none
    Outro card template.
  • transition · string · optionnel · cut | crossfade | whip_left | whip_right | zoom_punch | flash | swipe_up | glitch
    Default arrival for scenes naming none.
  • font_family · string · optionnel
    A list_options face.
  • caption_style · string · optionnel · karaoke | bold | boxed | minimal | outline
    Default caption style.

  Exemple d'appel

  {"name": "set_account_defaults", "arguments": {"look": "clean", "intro": "card", "model": "texte", "music": "texte", "voice": "Kore", "end_screen": "cta"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"defaults": {}}}

• set_brand_kit≈ 1107 tokens

  [Free] Partial update of a site's brand kit: logo, palette, face (named or an uploaded font), intro/outro templates, watermark and logo corner, default voice/music/captions/look/transition. null clears a field. Films of the site inherit it unless the call overrides.

  Paramètres, retour & exemple (17)

  Paramètres

  • look · string · optionnel · clean | bold | editorial | playful | tech
    Default look.
  • intro · string · optionnel · card | none
    Intro card template.
  • model · string · optionnel
    Clip model for ai_mode rich (list_models).
  • music · string · optionnel
    Default bed, or "asset:<id>".
  • voice · string · optionnel · Kore | Zephyr | Puck | Charon | Aoede | Fenrir | Leda | Orus
    Default narrator.
  • colors · object|null · optionnel
    Hex per slot; partial merges.
  • site_url · string · requis
    Any URL of the site.
  • watermark · boolean · optionnel
    Paid plans: badge on or off. Free keeps it.
  • end_screen · string · optionnel · cta | qr | social | logo | none
    Outro card template.
  • transition · string · optionnel · cut | crossfade | whip_left | whip_right | zoom_punch | flash | swipe_up | glitch
    Default arrival for scenes naming none.
  • font_family · string · optionnel
    A list_options face.
  • from_detect · boolean · optionnel
    Fill palette, face and logo from detect_brand first; your fields win.
  • logo_corner · string · optionnel · tl | tr | bl | br | none
    Logo corner on the picture, or none.
  • caption_style · string · optionnel · karaoke | bold | boxed | minimal | outline
    Default caption style.
  • font_asset_id · string · optionnel
    Font asset id (upload_asset kind "font"); outranks font_family.
  • logo_asset_id · string · optionnel
    Image asset id (upload_asset).
  • logo_safe_zone · number · optionnel
    Logo clear space, % of the short side.

  Exemple d'appel

  {"name": "set_brand_kit", "arguments": {"site_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"kit": {}, "domain": "texte", "exists": true, "painted": [], "detected": true, "font_url": "texte", "logo_url": "texte", "film_theme": "texte", "not_painted": [], "watermark_from": "texte", "account_defaults": "texte", "watermark_effective": true}}

• set_webhook≈ 284 tokens

  [Free] Sets (or with null clears) the account-wide URL that receives a signed JSON event whenever a render ends. The first time a secret is needed it is created and returned here, once.

  Paramètres, retour & exemple (1)

  Paramètres

  • url · string|null · requis
    Public https URL for the completion event of every render that has no callback_url of its own; null removes it. Signed as callback_url describes on create_video.

  Exemple d'appel

  {"name": "set_webhook", "arguments": {"url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"secret_set": true, "webhook_url": "texte", "webhook_secret": "texte"}}

• translate_video≈ 584 tokens

  [40 credits] per language: a NEW video from an existing one — same storyboard and pictures, narration translated, re-voiced and re-captioned, card text (rushie cards too) translated. Filmed scenes are re-recorded on the site's page in that language when it has one (hreflang), else the footage is reused and `scenes` says so. Charged and refunded like any render; AI visuals already made are reused free.

  Paramètres, retour & exemple (3)

  Paramètres

  • video_id · string · requis
    A finished video.
  • languages · array · requis
    One new video each.
  • idempotency_key · string · optionnel
    Same key within 24 h returns the videos already started, uncharged.

  Exemple d'appel

  {"name": "translate_video", "arguments": {"video_id": "texte", "languages": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"videos": [], "credits_charged": 1, "source_video_id": "texte"}}

• update_character≈ 406 tokens

  [Free] Changes a character's references, description or name; anything not given is kept. Clips already made keep the look they were made with.

  Paramètres, retour & exemple (4)

  Paramètres

  • name · string · requis
    The character's current name.
  • refs · array · optionnel
    1-3 reference image URLs from your bank, replacing the current ones.
  • new_name · string · optionnel
    Rename it. Scenes that name the old name must be updated.
  • description · string|null · optionnel
    What the character looks like; null clears it.

  Exemple d'appel

  {"name": "update_character", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"character": {}}}

• update_format≈ 921 tokens

  [Free] Changes any of a format's template fields. The result is a NEW version — the previous ones stay exactly as they were, and every episode already made keeps the version that made it. Shows following latest use the new version from their next run; pinned shows do not move until update_show moves them. Validated whole before anything is written.

  Paramètres, retour & exemple (20)

  Paramètres

  • goal · string · optionnel · explainer | ad | demo | tutorial | article
    As create_format.
  • name · string · optionnel
    A new name.
  • note · string · optionnel
    What this version changes, for the version history.
  • tone · string · optionnel
    As create_format.
  • intro · boolean · optionnel
    As create_format.
  • music · string · optionnel
    As create_format.
  • outro · boolean · optionnel
    As create_format.
  • theme · object · optionnel
    As create_video.
  • voice · string · optionnel
    As create_format.
  • scenes · array · optionnel
    animation formats: the scene templates, as create_animation's scenes (not from_library), with the placeholders in any string.
  • routing · object · optionnel
    As create_format.
  • language · string · optionnel
    As create_format.
  • format_id · string · requis
    The format_id from create_format or list_formats.
  • programme · object · optionnel
    As create_format.
  • subtitles · boolean · optionnel
    As create_format.
  • brand_name · string · optionnel
    As create_format.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    As create_format.
  • focus_template · string · optionnel
    As create_format.
  • target_seconds · integer · optionnel
    As create_format.
  • title_template · string · optionnel
    As create_format.

  Exemple d'appel

  {"name": "update_format", "arguments": {"format_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"format": {}, "version": 1}}

• update_member≈ 406 tokens

  [Free] Changes only the fields sent. Only the owner grants or changes admin and billing.

  Paramètres, retour & exemple (4)

  Paramètres

  • role · string · optionnel · admin | editor | reviewer | viewer | billing
    New role.
  • member_id · string · requis
    From list_members.
  • site_urls · array|null · optionnel
    Limit to these sites; null = all.
  • credit_cap · integer|null · optionnel
    Monthly credit cap; null = none.

  Exemple d'appel

  {"name": "update_member", "arguments": {"member_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"member": {}}}

• update_motion_template≈ 500 tokens

  [Free] Renames, retags, sets param defaults or visibility, or replaces the spec of a template you wrote. Films already using it keep their picture.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
    Rename it.
  • spec · object · optionnel
    A new spec for a template you wrote (save_motion_spec); checked like validate_motion_spec.
  • tags · array · optionnel
    Labels to find it by.
  • defaults · object · optionnel
    New default values for its params, by name.
  • visibility · string · optionnel · private | commons
    commons shares it with every account (owner/admin only).
  • template_id · string · requis
    The template's id.

  Exemple d'appel

  {"name": "update_motion_template", "arguments": {"template_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"template": {}, "warnings": []}}

• update_object≈ 600 tokens

  [Free] Changes only the fields sent. Media already generated with it is kept until a scene's description changes.

  Paramètres, retour & exemple (8)

  Paramètres

  • kind · string · optionnel · product | bag | watch | logo | packaging | place | vehicle | ui_screen
    What it is.
  • name · string · requis
    The object to change.
  • refs · array · optionnel
    Replace the references.
  • metadata · object · optionnel
    Merged into the metadata; a null value clears that key.
  • new_name · string · optionnel
    Rename it.
  • site_url · string · optionnel
    Scope it to one of your sites.
  • source_url · string · optionnel
    Where it comes from (a product page). Attribution only.
  • description · string|null · optionnel
    One line added to every prompt that names it.

  Exemple d'appel

  {"name": "update_object", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"object": {}}}

• update_show≈ 1117 tokens

  [Free] Changes a show's switch, cadence, caps or name, or moves it to another format or format version. The template itself is edited with update_format, which writes a new version and leaves every episode already made where it is. Nothing is rendered.

  Paramètres, retour & exemple (13)

  Paramètres

  • name · string · optionnel
    A new name.
  • active · boolean · optionnel
    false pauses the show (the scheduler skips it, run_show refuses); true resumes it.
  • source · object · optionnel
    query shows: a new source (same shape as create_show).
  • cadence · string · optionnel · manual | hourly | daily | weekly
    A new cadence.
  • show_id · string · requis
    The show_id from create_show or list_shows.
  • format_id · string · optionnel
    Move the show to another format of the same kind.
  • watchlist · array · optionnel
    watchlist shows: the new list; it replaces the old one. Items already made stay made.
  • repeat_every · string · optionnel · none | month | quarter | year
    query and watchlist shows: a new period, or none to stop repeating.
  • format_version · integer · optionnel
    Pin the show to this version of its format.
  • max_credits_per_day · integer · optionnel
    A new daily credit cap (an episode is 40 credits).
  • max_episodes_per_run · integer · optionnel
    A new per-run cap.
  • format_version_latest · boolean · optionnel
    true unpins the show so it follows its format's latest version.
  • rotate_webhook_secret · boolean · optionnel
    webhook shows: mint a new signing secret (returned once in this call's webhook_secret); the old one stops working at once.

  Exemple d'appel

  {"name": "update_show", "arguments": {"show_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"show": {}, "webhook_secret": "texte"}}

• update_storyboard≈ 4654 tokens

  [Free] Edits a video's storyboard in 22 operations, each described on its branch: words, captions, visuals (incl. "rushie" designed cards: data.rushie {template, props}), data, shots, scenes, transitions, fx, presenter, voice, music, look. Does not re-render — rerender_video makes the new film. Every call is snapshotted, so an edit can be undone (list_revisions).

  Paramètres, retour & exemple (2)

  Paramètres

  • video_id · string · requis
    The video to edit. Its scene ids come from get_storyboard.
  • operations · array · requis
    The changes, in order, up to 20; all are validated before any is written, so a bad batch changes nothing. A wrong figure is set_data plus one rerender_video, not a new video.

  Exemple d'appel

  {"name": "update_storyboard", "arguments": {"video_id": "texte", "operations": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"notes": [], "applied": [], "created": [], "video_id": "texte", "editor_url": "texte", "revision_id": "texte", "scene_count": 1, "needs_rerender": true}}

• upload_asset≈ 595 tokens

  [Free] Puts a file in your bank from a public https url or small data_base64 (a bigger file you hold: create_upload). Picture or clip → data.asset_id in an image scene; audio → music "asset:<id>"; deck (PDF/PPTX) → every slide's text and pictures, to write the storyboard from. Identical bytes return the existing asset.

  Paramètres, retour & exemple (6)

  Paramètres

  • url · string · optionnel
    Public https URL.
  • kind · string · optionnel · image | video | audio | font | deck
    Required with url. image ≤ 20 MB, video ≤ 200 MB/60 s, audio ≤ 50 MB, font ≤ 2 MB, deck (PDF/PPTX) ≤ 30 MB.
  • name · string · optionnel
    A label to find it again.
  • filename · string · optionnel
    Its file name.
  • site_url · string · optionnel
    Attach an image or clip to one of your sites.
  • data_base64 · string · optionnel
    The file, base64, ≤ 2 MB.

  Exemple d'appel

  {"name": "upload_asset", "arguments": {"url": "texte", "kind": "image", "name": "texte", "filename": "texte", "site_url": "texte", "data_base64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"use": "texte", "deck": {}, "asset": {}, "deduplicated": true}}

• validate_format≈ 799 tokens

  [Free] Compiles the template against a sample item, touching no database or feed: the catalogue checks (voice, music, language, theme…), the scene templates filled and checked as an animation, and what the first episode's title, brief and scene count would be. Returns problems by field; nothing is created, rendered or charged.

  Paramètres, retour & exemple (19)

  Paramètres

  • goal · string · optionnel · explainer | ad | demo | tutorial | article
    As create_format.
  • kind · string · optionnel · video | animation
    video or animation.
  • name · string · optionnel
    The format's name, for {{show}}.
  • tone · string · optionnel
    As create_format.
  • intro · boolean · optionnel
    As create_format.
  • music · string · optionnel
    As create_format.
  • outro · boolean · optionnel
    As create_format.
  • theme · object · optionnel
    As create_video.
  • voice · string · optionnel
    As create_format.
  • scenes · array · optionnel
    animation formats: the scene templates, as create_animation's scenes (not from_library), with the placeholders in any string.
  • routing · object · optionnel
    As create_format.
  • language · string · optionnel
    As create_format.
  • programme · object · optionnel
    As create_format.
  • subtitles · boolean · optionnel
    As create_format.
  • brand_name · string · optionnel
    As create_format.
  • aspect_ratio · string · optionnel · 16:9 | 9:16 | 1:1 | 4:5
    As create_format.
  • focus_template · string · optionnel
    As create_format.
  • target_seconds · integer · optionnel
    As create_format.
  • title_template · string · optionnel
    As create_format.

  Exemple d'appel

  {"name": "validate_format", "arguments": {"goal": "explainer", "kind": "video", "name": "texte", "tone": "texte", "intro": true, "music": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"valid": true, "sample": {}, "problems": []}}

• validate_motion_spec≈ 480 tokens

  [Free] Dry-run a spec: deterministic repairs, schema, params, layout/legibility/contrast/timing on four frames and the motion doctrine. Returns ok, every problem with its path and fix, the repaired spec and the params schema. Nothing is saved.

  Paramètres, retour & exemple (3)

  Paramètres

  • spec · object · requis
    A motion spec (get_motion_grammar).
  • params · object · optionnel
    Param values to check it with (default: the declared defaults).
  • site_url · string · optionnel
    Lint against this site's brand colours.

  Exemple d'appel

  {"name": "validate_motion_spec", "arguments": {"spec": {}}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"ok": true, "errors": 1, "repairs": [], "problems": [], "warnings": 1, "example_scene": {}, "params_schema": [], "repaired_spec": {}}}

• verify_episode≈ 714 tokens

  [Free] The proof behind a film: the format version that made it (template SHA-256), every resolver source and what it fetched, the integrity report, the claim ledger (which figures trace to the page, the brief or nothing), the Content Credentials (C2PA), and a check recompiling the stored data against the narration word for word.

  Paramètres, retour & exemple (2)

  Paramètres

  • video_id · string · optionnel
    Or a video id: the episode is found through it when there is one; a plain video is verified on its claim ledger and credentials.
  • episode_id · string · optionnel
    The episode to verify, from run_show or a show's recent_episodes.

  Exemple d'appel

  {"name": "verify_episode", "arguments": {"video_id": "texte", "episode_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"claims": {}, "format": "texte", "verdict": "texte", "page_url": "texte", "video_id": "texte", "episode_id": "texte", "provenance": "texte", "credentials": "texte", "video_status": "texte", "recompiled_matches": true}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://pagetovid.com/mcp