Motion Graphics Videos in the Pictory MCP Server
A new level of visual storytelling, created through conversation. Pictory now supports motion graphics videos in Claude and other connected assistants. Bring your message to life with animated headlines, charts, diagrams, and scenes designed around your story. Time visual reveals to narration so ideas arrive clearly and key moments stand out.- Choose your video style first. Ask for a standard video or motion graphics. Claude helps you settle the direction before creating the scenes.
- Create in Claude, continue in Pictory 3.0. Every motion graphics video is saved as an editable project in your connected Pictory account. Open the project link to refine it in the Motion Studio editor in Pictory 3.0 without rebuilding your scenes.
- Choose the right Brand Kit 2.0. Select a kit from Pictory 3.0 or choose None. Bring your colors, fonts, logo, tone of voice, and supplied intro and outro into the video.
- Direct the sound and movement. Choose narration or no voice-over, music throughout or scene by scene, and transitions that suit the story. Finalize narration, narrator, music, and scene count before creation; later chat revisions refine the visual design.
- Use the media you want. Choose stock media, AI-generated images and clips, both, or graphics alone. Select your AI models, and choose an alternative if AI Credits are insufficient.
- Review before you finish. Preview the video, request visual revisions, and receive share and download links when the finished video is ready.
Existing users: Disconnect Pictory, remove the connector, then add it again and sign in to
get the new features. Your saved projects stay in Pictory. Follow the
update steps.
Videos rendered on a Free Trial account include Pictory watermarks and a Pictory-branded outro.
Pictory adds these during rendering; the outro is separate from your authored scenes and any
outro supplied by your Brand Kit.
Music Chosen Scene by Scene in the Pictory MCP Server
Pictory MCP server. When you design a video together with Claude, the music no longer has to be one track for the whole video.- A new question. If you want music, Claude asks whether one track plays under the whole video or a mix of tracks is chosen scene by scene. When Pictory designs it, one track plays under the whole video, as before.
- A track per part of the story. For a mix, Claude waits until the scene list is agreed, groups neighboring scenes that share a mood, searches Pictory’s music library separately for each group, and offers a different track for each. A track plays on across its group without restarting.
- The scenes in between. If some scenes are left without a track, Claude asks whether they play one track underneath or have no music. Every track in a mix is chosen from the library; there is no automatic pick for a scene.
- Levels. Each track sits at a low level under narration, or under an AI clip’s own sound, unless you ask for another level.
- Editing a preview. The music of a mix is one soundtrack on the preview: in place, you can make all of it quieter, or replace it with one track that then plays under every scene, including any that had no music. A different track on some scenes, or music louder than designed, means a fresh preview, which reuses the narration already voiced.
Scene-Level Music: A Different Track and Volume for Each Scene
Text-to-Video API. A scene can now play its own music, instead of only turning the video’s music on or off.musicUrl. The music for a scene: a public link to an audio file, or anaudioUrlfrom Search Music Tracks. Tracks from Search Music Tracks are licensed for you.volume. How loud the scene’s music is, from 0 to 1. Use it withmusicUrl. If left out, the scene uses the video’s music volume.enabled. No longer required when you setmusicUrl. Set it tofalsefor no music in a scene, as before.- One soundtrack. All the scene music is joined into one soundtrack:
- Scenes next to each other with the same
musicUrlkeep the music playing without starting over. - The video’s music picks up where it would have been.
- Short tracks repeat, and changes between tracks fade.
- Scenes next to each other with the same
- Music on a few scenes only. Set the top-level
backgroundMusic.enabledtofalse, and scenes without amusicUrlare silent. - Previews and saved projects. The storyboard has one music element that plays the whole soundtrack. A project saved with
saveProject: truekeeps it as one custom music track. - YouTube clearance. If a video uses more than one library track,
youtubeClearanceCodecovers the one that plays the longest. - New job error codes:
MUSIC_URL_UNREADABLE: amusicUrlcould not be read as audio.MUSIC_LICENSE_FAILED: a library track could not be licensed.SCENE_MUSIC_BUILD_FAILED: the soundtrack could not be built.
AI-Generated Media in the Pictory MCP Server, and Scenes Carried by an AI Background
Pictory MCP server. When you design a video together with Claude, the scenes can now use AI-generated media instead of stock.- AI-generated media, step by step. Claude asks whether to use stock or AI-generated media, then images, videos or let AI decide, whether the clips have sound, which model, and, for two or more AI scenes, continuity and a subject that must look the same.
- New tool:
list_ai_models. Lists the models that fit your answers and the video’s shape, cheapest first, with the AI Credits for one clip or image. The server now has fourteen tools. - Credits before any preview.
estimate_layout,preview_video_from_textandcreate_video_from_textreturn the AI Credits a design draws, with cheaper options such as another model, no sound on narrated clips, or stock media. Claude goes ahead only when you agree. - Scenes carried by their clip. A person speaking in the clip, or its own sound such as a cafe or waves, can carry a scene with no narration. Claude does not ask about a voice or subtitles for those scenes, and any music plays quietly under the clip’s sound.
- Data stays on top. Generated media shows the scene only; numbers, labels and charts are drawn as elements over it, and Pictory adds where the subject should sit so they land on plain background.
- Preview or render, in either mode. Claude now offers a preview first or the finished video straight away in Design it together too, and says what each means.
- Timing. Each AI-generated clip adds 3–4 minutes to a preview or render, because clips are generated one after another.
- Pictory designs it. An AI-generated background you name is generated for every sentence of that scene’s narration, and the result now reports the estimated AI Credits.
- No content source needed. A scene with no
story,brief,blogUrl,pptUrl,audioUrlorvideoUrlis accepted whenbackground.aiVisualis set. Previously only avisualUrlor acolorbackground allowed this. - Prompt required. Such a scene must set
background.aiVisual.prompt, because there is no story to write one from. - Sound plays on these scenes too. An AI video clip generated with
audio: truealready played its sound in a narrated scene; it now does in a scene with no story as well, such as dialogue spoken in the clip or ambience, unlesssettings.muteistrue.
FeatureBreaking
AI Studio and Storyboard AI Visuals: Audio, New Models, Multi-Reference Editing, Frame Transitions
AI Studio and Storyboard AI Visuals: Audio, New Models, Multi-Reference Editing, Frame Transitions
The AI Studio endpoints now expose the capabilities that shipped in the Pictory app in September, and storyboard AI visuals get the same models and options.- Audio.
POST /v1/aistudio/videosacceptsaudio: trueto generate synchronized sound, effects, and speech with the video. Audio is a separate per-second rate per model.omni-flashalways produces audio;audio: falseis rejected there. - New video models.
pixverse6(up to15s, eight aspect ratios including21:9, extension, transitions) andomni-flash(10s, audio always on).pixverse5.6is the documented budget option. The default model ispixverse5.6; requests that still send the retiredpixverse5.5are served and billed aspixverse5.6. - New image models.
nanobanana2(8 credits) andnanobanana-lite2(4 credits, edits served bynanobanana2at the lite rate). - Multi-reference image editing.
POST /v1/aistudio/imagesacceptsreferenceImageUrlswith up to four images. The singularreferenceImageUrlkeeps working. - Frame transitions.
endFrameImageUrl, alongsidefirstFrameImageUrl, generates a clip that starts on one image and ends on another (pixverse6,pixverse5.6). - Reference limits per model. Video
referenceImageUrlsnow allows up to four images on Pixverse models; Veo keeps the existing limit of three, and Omni Flash takes one. Onveo3.1andveo3.1_fast, reference images require an8sduration; other values are rejected before credits are reserved. - Highest quality by default. Generated videos are delivered at the highest resolution the model supports, 1080p on Pixverse and Veo (720p for
pixverse6at15s, Veo clips shorter than8s, and Veo extensions;omni-flashtops out at 720p). Credits are unchanged, and the capabilities endpoint reportsmaxResolutionper model. Sendresolution: "720p"for a lighter file. - Listing fields. Videos carry
audioandendFrameImageUrl; images carryreferenceImageUrls. Both carryenhancedPromptwhen prompt enhancement ran, and completed jobs return it too. - Model capabilities endpoint.
GET /v1/aistudio/modelslists every model with its accepted ratios, durations, reference limits, audio support, and features, generated from the same rules that validate requests. - Training presets.
trainingPreset(sales-training,product-training,soft-skills-training) steers the prompt enhancer toward training content on both endpoints, and always turns enhancement on, even whenenhancePromptisfalse. - Storyboard AI visuals.
scenes[].background.aiVisualand media elementaiVisualon the storyboard and render endpoints get the same models and options:pixverse6,pixverse5.6,omni-flash,nanobanana2,nanobanana-lite2,nanobanana-pro,nova-canvas;referenceImageUrlslimits per model instead of 2 on every video model (4 on Pixverse, 3 on Veo, 1 onomni-flash), and on image scenes for the first time (up to 4, 1 onnova-canvas);audio(off by default, with-audio rate);endFrameImageUrltransitions;trainingPreset(always turns prompt enhancement on);enhancePrompt(off by default, so written prompts are used as written); a clip generated with audio plays it unlesssettings.muteistrue; andresolution(1080p by default).
Pictory MCP Server for Claude and Claude Code
Pictory now runs a remote MCP server athttps://mcp.pictory.ai/mcp that exposes the Text-to-Video API as tools for Claude. Add it as a custom connector in Claude, or register it in Claude Code with one command, sign in with your Pictory account, and describe the video you want. Claude writes the script, designs the scenes, finds the visuals and music, renders through your account, and hands you the links.- Two design modes: let Pictory’s AI Storyboard design every scene from a brief, a script or a blog URL, or design each scene together with Claude and edit the preview in place before rendering.
- Thirteen tools: create and preview videos, render an approved preview, inspect and edit a preview’s elements, estimate a layout, search stock media and music, list voices, brand kits and text styles, and check your quota.
- Your account, your plan: there is no API key to manage. Sign-in is your Pictory account, and video minutes, premium voice minutes and AI Credits are drawn from its API subscription.
YouTube Content ID Clearance Code for Licensed Background Music
When a rendered video uses a track from Pictory’s licensed music library (Melodie), for example throughbackgroundMusic: { "enabled": true, "autoMusic": true }, YouTube may raise a Content ID claim on upload. The job status response now includes the code that clears it.- New fields on
GET /v1/jobs/{jobId}for completed render jobs:youtubeClearanceCodeandyoutubeClearanceExpiresAt. Enter the code in YouTube Studio to release the claim on that video. - Present only when needed. Jobs with no background music, or with your own
musicUrl, are unchanged. The fields also appear in the job completion webhook payload. - One code per video, valid for 7 days. Polling the job again returns the same code until it expires, after which a fresh code is issued. Each code clears a single video upload.
- Works for existing jobs. Any completed job with library music returns a code on its next status call.
AI Storyboard: Let AI Design Every Scene
AddaiStoryboard: { "enabled": true } to a POST /v2/video/storyboard or POST /v2/video/storyboard/render request and the AI designs every scene: a layout, on-screen text elements, and a color palette per scene, instead of a full-screen visual with subtitles.- Script mode: send
storyorblogUrlscenes and the AI designs around your narration, word for word. Story scenes are split one designed scene per sentence by default. - Brief mode: send a single
briefscene and the AI writes the narration and designs the storyboard in one pass. A render job returns the generated narration intxtFile,srtFile, andvttFile; a preview job returns it instoryboard.scenes[].story. - Text-to-video only: templates, smart layouts,
variables, the4:5ratio, and presentation, audio, and video sources are rejected with an explicit message. The design step adds 1–3 minutes to the job.
storyCoPilot scene object is now brief, and its videoType field is now videoGoal. Existing requests that still send storyCoPilot keep working.See the new AI Storyboard guide and the aiStoryboard Object reference.Slide Animation Controls: Model Selection and Per-Slide Targeting
PowerPoint slide animation is now configured with a scene-levelpptSlideAnimation object, which adds control over the animation model and over which slides are animated.enabled: set totrueto animate slides.model: choose the video model, one ofpixverse6,veo3.1_fast, orveo3.1. Defaults topixverse6when omitted, which does not consume AI credits. Theveo3.1andveo3.1_fastmodels consume AI credits and reproduce small slide text more reliably. Clips are capped at 10 seconds.slides: animate only the slide positions you list, starting at 1. Omit or pass an empty array to animate every eligible slide.
Media Elements: Video and Image Overlays at Scene Creation
The scene-levelelements array now supports video and image overlays alongside shapes and text. Place a product demo picture-in-picture, drop a screenshot next to your narration, or generate an illustration from a prompt, all in the same POST /v2/video/storyboard request.Each media element is sourced in one of three ways:- Your own media: set
visualUrlto any publicly reachable video or image file. Duration and proportions are detected automatically. - Stock library search: set
searchFilter.queryto a plain-language description and Pictory finds a matching stock visual. Respects the request-levellanguage. - AI generation: set
aiVisualwith apromptandmodel(same models and AI Credit rates as background AI visuals).
- Anchor presets (
top-leftthroughbottom-right) or exacttop/leftpercentage offsets. - Explicit
widthis used as given:"100%"withtop: "0%",left: "0%"fills the whole frame. - No
width? The element sizes itself automatically and shrinks to stay fully on screen, based on its position and the media’s proportions. - Video playback settings:
loopandmute, both defaulting totrueso overlays never compete with your narration. - Per-element color overlay: tint an individual element with
colorOverlay, independent of the scene background.
Background Color Overlay: Tint Any Scene Background
NewcolorOverlay field on scene backgrounds: a semi-transparent tint rendered on top of the background visual, like looking at your footage through tinted glass. Use it to keep subtitles readable on busy footage, wash scenes in your brand color, or set a mood without editing the source media.- Two fields:
color(RGB, RGBA, or hex) andopacity(0–1, default0.4). - Works everywhere: auto-selected visuals, stock search, direct URLs, AI-generated visuals, solid color backgrounds,
backgroundBrolls[]items (a B-roll’s own overlay takes precedence while it is on screen), andvideo/imagemedia elements. - Scenes with a
colorOverlayare routed to the v3 storyboard engine automatically.
Scene Elements: Shape and Text Overlays at Scene Creation
You can now attach decorative shape and text overlays to a scene directly in thePOST /v2/video/storyboard request, using the new scene-level elements array. Previously these overlays were only editable after a storyboard preview was generated; you can now seed them at creation time.- Shapes: 3 basic shapes (
rectangle,circle,line) plus 130+ library shapes across families like badges, arrows, stars, quotes, doodles, blobs, hearts, and speech bubbles. - Text: Three decorative presets (
heading,subheading,body) with optionalstyleoverrides for font, color, alignment, case, and decorations. - Positioning: Nine anchor regions (
top-leftthroughbottom-right) with percentage-basedwidth,top, andleftoffsets.
FeatureDocumentation
PowerPoint Animated Slides, Multilingual PPT Narration, LLM-Friendly Docs, and OpenAPI Spec
PowerPoint Animated Slides
New scene-level fieldanimatePPT enables AI-generated slide animations (zoom, pan, fade) for image-heavy PowerPoint decks. Only valid when used with pptUrl.- New guide: PowerPoint to Video with Animated Slides. Covers
animatePPT, feature combinations, and best practices for when to apply animations. - Existing PowerPoint AI Voiceover and Speaker Notes guides now document
animatePPT. - The field is also documented in the Create Storyboard Preview API reference.
Multilingual PowerPoint Narration: Translate Decks at Render Time
The top-levellanguage field is now documented for the PowerPoint-to-video flow, which means you can generate the video in a different language from the one your PowerPoint deck is written in. Submit an English deck with language: "fr" and Pictory generates the narration directly in French; no need to translate your slides first.- 14 supported languages: Chinese (
zh), Dutch (nl), English (en), French (fr), German (de), Hindi (hi), Italian (it), Japanese (ja), Korean (ko), Marathi (mr), Portuguese (pt), Russian (ru), Spanish (es), and Tamil (ta). - One deck → many language outputs: ship the same source PPT to multiple international audiences without maintaining translated copies.
- Works with both narration sources: whether the AI is reading the slide text or the speaker notes (
useSpeakerNotes: true), the output is translated into the targetlanguage. - Combines with
animatePPT: add slide animations on top of multilingual narration in the same request. - Documented voice per language: each
languagehas a default male STD voice you can use straight away (e.g.,Martinfor English,Gabrielfor French,Wilburfor German). See the End-to-End Recipes guide for the full language → voice mapping.
LLM-Friendly Documentation
New resources that make the Pictory API easier to consume for Large Language Models, code generators, and agentic tools.- OpenAPI 3.1 specification: Available at
docs.pictory.ai/openapi.json. Covers the five most-used endpoints (Create Storyboard Preview, Render Storyboard Video, Render Project, Get Job by ID, Get Video Brands) with 34 component schemas. Use it for SDK code generation, Postman or Insomnia import, or as a structured tool schema for LLMs. - End-to-End Recipes guide: Ten complete, ready-to-run JSON payloads for the most common use cases, including text-to-video, multilingual narration, PowerPoint, avatar walk-throughs, template-based renders, brand kits, webhooks, previews, and job polling.
- Use Pictory with an LLM guide: Recommended system prompt, example natural-language to API-call mappings, and Pictory MCP server pointers.
- AI Tools setup guides: Project rules and configuration templates for Claude Code, Cursor, and Windsurf. Each guide teaches the tool the Pictory API conventions, including the raw-key authentication pattern and mutually-exclusive field constraints.
llms.txtandllms-full.txt: Mintlify auto-generates these atdocs.pictory.ai/llms.txtanddocs.pictory.ai/llms-full.txt. Hand either URL to any LLM to make it Pictory-aware in one shot.
AI Credits: Unified Currency for Generative AI Features
AI Credits are now a single unified currency for Pictory’s generative AI features: AI Image generation, AI Video generation, and AI Avatars. API customers receive AI Credits as part of their plan; unused credits roll over to the next billing cycle and never expire while the subscription stays active.Track consumption and remaining balance with the Get Current Quota and Get AI Credits Usage endpoints.For the full breakdown of per-model rate cards, add-on packs, and Teams pooling, see Understanding AI Credits in the Pictory Help Center.Account and Usage API
Two new endpoints for monitoring your subscription usage and AI credit consumption.Get Current Quota- Retrieve real-time usage for video minutes, transcription minutes, ElevenLabs voice-over minutes, and AI credits.
- Each metric shows
usedandlimitvalues for the current billing term. - Use this to display usage summaries, gate features based on remaining quota, or verify capacity before launching jobs.
- Retrieve a per-transaction ledger of AI credit activity with date, amount, source, and direction (credit or debit).
- Filter by year and month to query specific billing periods.
- Transaction sources include AI Avatar, Text-to-Image, AI Video, Add-on Purchase, and Promotional Credits.
- History available for the last 12 months.
ElevenLabs Voice Auto-Discovery
You can now use any voice from the ElevenLabs catalog without manual setup. Pass the ElevenLabs voice ID directly as thespeaker value in your voiceover configuration, and Pictory will automatically discover and add the voice to your library.- No manual voice registration: the Add Voiceover Track endpoint is no longer needed for ElevenLabs voices.
- Pass any ElevenLabs voice ID as the
speakerfield (e.g.,"pNInz6obpgDQGcFmaJgB"). - Automatic library addition: once discovered, the voice is available by name or track ID in future requests.
- Premium voice settings: fine-tune stability, similarity boost, style, and model selection.
POST /v1/voiceovers/tracks endpoint has been removed. ElevenLabs voices are now added automatically on first use.See the ElevenLabs Voices Guide for full documentation.AI Visuals: Visual Continuity, Reference Images, and Creative Direction
New features for AI-generated scene backgrounds that give you greater creative control over video and image generation.Visual Continuity- Enable
visualContinuityto create seamless transitions between consecutive AI-generated scenes. - Works with both video clips and images.
- The system uses the output of each scene as a reference for the next, producing a cohesive visual flow.
- Continuity applies within the same story and across consecutive stories when enabled.
- Use
firstFrameImageUrlto control the starting frame of an AI-generated video clip. - The AI model generates a video that begins from your provided image and transitions into the motion described by the prompt.
- Use
referenceImageUrlto guide the style and composition of AI-generated images with a reference image. - Influence the color palette, lighting, and visual tone while generating new content from your prompt.
- Use
referenceImageUrlsto provide 1–2 reference images that guide the style of AI-generated video clips. - When using
veo3.1orveo3.1_fastwith reference images, the video duration is automatically set to"8s".
- When a story is split into multiple scenes, the
promptfield acts as a creative direction for the entire video. - The system uses your creative direction to guide the auto-generated prompts for each individual scene.
- Recommended structure: [Action/Movement] + [Scene/Environment] + [Camera Technique] + [Visual Style].
- Job responses now include
aiCreditsUsedwhen AI visuals are generated, reporting total credits consumed across all scenes.
AI Studio: AI Image and Video Generation
Pictory now offers AI Studio, a new set of APIs for generating AI-powered images and videos directly from text prompts. AI Studio gives you access to multiple AI models, aspect ratios, visual styles, and advanced creative input modes.Image Generation- Generate images from text prompts with your choice of AI model and visual style.
- Use a reference image to create variations, replace subjects, or apply transformations.
- Choose from models including
seedream3.0,flux-schnell,nanobanana, andnanobanana-pro. - Apply visual styles such as
photorealistic,artistic,cartoon,minimalist,vintage, andfuturistic.
- Generate videos from text prompts with configurable duration and aspect ratio.
- Start a video from a specific image using the first frame input for precise visual control.
- Extend an existing video with new AI-generated content that continues from the original.
- Provide up to three reference images to guide subject appearance and scene composition.
- Choose from models including
veo3.1,veo3.1_fast, andpixverse5.5.
- Retrieve paginated lists of all your generated images and videos.
- Results are sorted by creation date with the most recent items first.
- Every completed job reports the number of AI credits consumed.
- Image generation is charged per image, and video generation is charged per second of output.
- See the rate card in each model’s documentation for exact pricing.
Dynamic Captions with Word-Level Timing
Dynamic captions now render subtitles word by word, synchronized precisely with the voiceover audio. This produces a more engaging viewing experience where each word appears on screen as it is spoken.- Set
maxSubtitleLinesto a value from1to4to control how many lines of subtitles are displayed at a time. - Word-level timing is applied by default when dynamic captions are active.
