Un endpoint. Un editor video completo.

List the user's BlitzReels projects with status, duration, and basic metadata.

Get details for one BlitzReels project, including timeline summary, clips, captions, and current recovery state with an app path and next read tool.

Read bounded project context for editing, including timeline items, media assets, transcripts, captions, and stable IDs.

List exports with render status and progress. Completed exports include a signed download URL. Pass exportId to return one export.

Read a WebVTT caption track from the completed export's immutable canonical speech snapshot, preserving the actual export trims. Returns unavailable for older exports or unverified speech; never fabricates captions from titles or current edited timelines.

Replace one shot's media asset while preserving the other timeline items. Revision checked; dryRun previews by default. Requires a current editor snapshot and an asset in the same workspace.

Adjust one item's volume and audio fades. Revision checked; dryRun previews by default. Preserves the rest of the project.

Create or revise one title or text overlay with explicit timing. Revision checked; dryRun previews by default. This edits project text, not spoken audio or captions.

Adjust the crop of one existing source view after a layout has been applied. Revision checked; dryRun previews by default. Preserves the other shots.

Insert a workspace image, generated shot or audio asset at an explicit project time. Revision checked; dryRun previews by default.

Move selected timeline items to explicit times and layers. Revision checked; dryRun previews by default.

Remove selected timeline items and, if requested, their linked captions. Revision checked; dryRun previews by default. The saved action can be undone.

Read the current revision, stable timeline IDs, captions, style and bounded media context before a precise revision. Signed media links are refreshed by reading again.

Read up to 50 saved edit actions, their labels and undo state. Does not restore or change the project.

Restore one saved editor action at the expected current revision. Requires the action ID from edit history and an idempotency key. Existing project data is changed.

Read existing suggested moments with source ranges, hooks, transcript excerpts and thumbnails before producing videos. Results are bounded; this does not generate suggestions or render clips.

Read bounded editable caption words and stable word IDs for one project, optionally matching text.

Replace selected caption words by their stable IDs. Preserves timing and the other captions; this does not change the spoken audio.

Save the user's 1-5 rating and optional quality category/comment against one completed playable video export. Replaces that user's previous feedback for this export; does not change accepted clips or defaults. Requires the feedback storage migration to be installed.

Restore editable project captions from the selected source's completed canonical transcript. Keeps the full recording and avoids duplicate captions on identical retries. Requires source transcription first; no-speech is an explicit successful state.

Recover a terminal batch's missing clip count through the persisted recovery workflow. Preserves accepted clips and returns the recovery batch ID. Can spend existing account credits; retry with the identical idempotency key.

List bounded workspaces the connected user belongs to, with their role and default workspace. Selecting a workspace for the task does not change account defaults.

Read the selected workspace's business audience, offer, reviewed brand defaults, protected vocabulary, editorial purpose, language, avoided terms, pronunciation notes and existing account entitlements. Returns current export quality and watermark constraints without pricing or upgrade links.

Save the user-reviewed business name, audience, offer, conversion goal, tone, protected vocabulary and editorial preferences for the selected workspace. Requires workspace settings permission and confirmReviewed=true; changes future assistant guidance, preserving existing projects. Pronunciation notes guide script drafting; they do not retime or replace source speech.

Start extracting a brand profile from the exact website the user supplied and authorized to scan. Saves a draft profile for review; does not apply discovered fields to existing videos. Can spend existing account credits.

Read one authorized website extraction run and its draft business profile. Show the extracted fields to the user for review before saving them as defaults.

Read bounded existing provider-reported engagement in the selected workspace, sorted by views. Returns source title, caption, published date and views/likes/comments/shares/saves. Does not import new data, start monitoring or infer attributable leads, sales or revenue.

List media files in user's library (videos, audio, images)

Get transcript summary metadata or a bounded window of transcription segments for a video asset.

Import a video, audio, or image file from ChatGPT into the BlitzReels media library. Use this for a file the user attached or picked, and for an image ChatGPT generated in this conversation that the user wants to keep, animate, or edit in BlitzReels.

Import a video, audio, or image from a user-provided direct URL into the private BlitzReels media library.

Get a presigned URL for direct file upload (for large files)

Complete the upload process after uploading to a presigned URL

Inspect a user-provided public social-video or Google Drive URL and return available import metadata without creating media.

Scan a user-controlled public page and return an importable video URL found on it without creating media.

Get metadata and processing state for one media-library asset without returning transcript segments.

Return one bounded JPEG as MCP image content for visual inspection. Images use the stored visual; videos use the existing thumbnail.

List one bounded level of media-library folders and direct asset counts.

Create one media-library folder in a workspace and return a retry-safe mutation receipt.

Rename one media asset, edit its description, move it to a folder, or change B-roll eligibility. Provide at least one of name, description, folderId, or allowUsingAsBroll.

Estimate ByteDance upscale eligibility and credits for one stored video. Does not spend credits or queue a job. Call this before media_upscale.

Queue a ByteDance upscale of one stored video asset to 1080p or 4k. Call media_upscale_estimate first. Spends AI credits and returns a new pending media asset to poll with media_assets_get.

Create a private BlitzReels clip batch from an existing asset or a user-provided video URL. Supports public social videos, Google Drive, and direct media URLs.

Get status, generated clips, render counts, and download links for a BlitzReels clip batch.

List or inspect clips, regenerate, repair visual QA, start export, promote an accepted delivery export, inspect caption words, or apply a verified caption look.

Preview or delete a terminal clip batch. Dry-run is the default; real deletion requires explicit confirmation, retention choice, workspace delete permission, and an idempotency key.

Read one existing batch's progress, ready clips and renewed signed links without opening or remounting a review widget. Safe for bounded polling and widget refresh; does not recreate or repair clips.

List bounded managed clips from the selected source or project with their current workflow state.

Read one managed clip's selected source range, project, workflow state and delivery information.

Replace the source moment for one managed clip using a verified suggestion or explicit time range. Can spend existing account credits. Preserves the other clips; read current state before retrying.

Request a layout repair for one managed clip, such as preserving a screen demo or moving captions away from faces. Changes that clip's project; preserves the other clips.

Render one managed clip at an existing-account-supported quality. Returns persisted export state; inspect until the accepted delivery file is ready. Can spend existing account credits.

Apply a verified caption look to one project. Preserves word overrides unless clearWordOverrides=true. Existing captions are restyled; spoken audio is preserved.

Read bounded camera and screen recording sets in the selected workspace with status, duration and alignment warnings.

Read one camera and screen recording set, its primary speaker, content windows, alignment and warnings. Separate audio-only tracks are not supported.

Create an empty camera and screen recording set in the explicit workspace. Requires existing recording-set access; does not import files or start processing.

Attach one existing authorized video asset as a camera or screen track. Specify the main speaker when known; alignment happens during finalization.

Finalize the collected camera and screen tracks and queue analysis. Can spend existing transcription credits. Inspect returned alignment and warnings before clipping.

Produce a batch from a ready synchronized camera and screen recording, with optional clip count, maximum duration and caption look. Preserves readable screen context through the existing layout pipeline. Can spend existing credits; follows clips_get with the returned batch_id.

Read whether the source video's clip share page is public and which clips are visible. Does not publish content.

Make the selected source video's clip page public with reviewed title, description and explicit download permission. Requires confirmPublicSharing=true from the user. Returns the verified public URL; no social network post is made.

Disable public access to the selected clip page. Changes an existing publication; preserves private projects and exports.

Show or hide one identified clip on an existing public review page after explicit user confirmation. Preserves the other clips and private project data.

Create a new private BlitzReels video project.

List available clip batch presets and their clipping/caption defaults.

List built-in caption looks and saved caption themes available to a workspace.

Trim or extend one timeline item. Split one timeline item at an exact sequence position.

Preview without mutation. Trim or extend one timeline item. Split one timeline item at an exact sequence position.

Create or update up to 20 visual blocks in one call after edit timing is settled. Presets: broll-headline, steps, quote, end-screen, key-number, before-after, screenshot-focus, chapter. IDs are scoped to the project; repeating an ID updates it. Asset IDs must belong to the workspace. Atomic, undoable; dryRun validates without writing. Returns IDs and revision. No generation pass.

Update one timeline item's start, duration, trim, layer, ignored state, or blurred background. Provide at least one field to update besides timelineItemId.

Update timing, trim, layer, or state for up to 100 timeline items in one sequence transaction.

Set one timeline media item's volume to zero.

Preview or delete up to 100 timeline items and optionally remove linked captions.

Add an opening title card (hook) or generic text overlay to a project timeline. Defaults to classic white: black text on a white card.

Add a timed transition effect, optionally attached to one timeline item and paired with sound.

Place an image or video asset onto a BlitzReels project timeline at a timestamp, including B-roll and static images.

Place an audio asset onto a BlitzReels project timeline at a timestamp for voiceover, music, or sound.

List public BlitzReels workflows that can be imported into a workspace.

Import a public BlitzReels workflow into the user's workspace.

Get a workflow definition, input schema, defaults, and ordered steps.

Create an interactive workflow run from a workflow and optional inputs.

Get workflow run status, step statuses, outputs, warnings, and dashboard URL.

Execute one pending workflow run step and return updated run status.

Render a BlitzReels video project and return export and job IDs for status checks.

List the models, defaults, limits, and credit costs available for one generation kind before queueing it. Video duration is an enum per model (durations_seconds), not a min-max range.

Queue an AI image generation into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Queue video generation, image animation, source-video editing or character replacement into the media library. Editing accepts referenceVideoAssetIds and transformation controls, including original-audio preservation. Spends AI credits and returns a job readable with generation_jobs_get.

Queue a text-to-speech voiceover into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Queue a background music track into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Queue a sound effect into the BlitzReels media library. Spends AI credits and returns a job to poll with generation_jobs_get.

Turn a script into a full faceless video project: scene plan, generated visuals, optional voiceover, captions, music, and sound. Spends AI credits and returns a job to poll with generation_jobs_get.

Check a queued generation. Completed jobs carry the media asset ID and a download URL.

Request cancellation of the identified queued or running generation. Work already performed can consume credits; cancellation does not establish a refund.

Read a generation brief from rawPrompt. Source-video edits return execution for generation_video_create with required assets and transformation controls. New scenes return an authoring grammar and planJsonSchema for generation_plan_validate. This read does not generate media or spend credits.

Validate a self-authored generation plan against the schema and the target model's real capabilities before execution. Returns directive errors to fix and revalidate; only a valid plan is executable.

Create a vertical video storyboard for the user-approved script in an existing project. Spends planning credits; returns scene narration, factual review notes, references and the production credit estimate. Does not generate images or animate video. Existing account access applies.

Read one authorized storyboard revision, its scene and reference previews, estimate, approvals and bounded polling guidance. Refreshes signed previews. Complete means the editable timeline is assembled; use exports_start and exports_list for a downloadable MP4.

Create a new immutable draft from a known revision with selected scene, character or model changes. Preserves other scene definitions; requires review and production approval again. Does not generate media or overwrite an approved revision.

After showing the storyboard and its credit estimate, confirmApproved=true starts production of reference images and scene keyframes. Spends existing credits. This stage produces reviewable previews, not animated videos.

After the user approves the generated previews and animation cost, confirmApproved=true starts scene animation, narration and editable timeline assembly. Can replace the project's generated timeline and spend existing credits. Follow the revision and then export the finished project.

Replace the identified preview after user approval of the new credit cost. A scene_keyframe changes one keyframe; a character_anchor refreshes its dependent keyframes; a style_anchor refreshes every keyframe. Preserves unaffected previews. Does not regenerate an already finished video shot.

List bounded reusable characters with identity, voice, facts, and image-reference metadata.

Inspect one reusable character and its ordered reference-image set before planning a story.

Create or update a reference-based character for repeatable faceless story generation.

List bounded reusable Story Kits that bind characters, locations, style, facts, and narrator voice.

Inspect one Story Kit and its revision before generating or updating a story.

Create or update a Story Kit with optimistic concurrency and an idempotent mutation receipt.

List optional Series with bounded counts and cover previews.

Read a Series identity, creative defaults and revision.

List sources or projects in a Series. Null seriesId lists standalone content. sourceId filters projects by clip origin.

Create or replace a Growth+ Series identity and defaults. defaultCreationMode selects podcast branding or faceless Story Kit defaults; membership stays mixed. Updates require expectedRevision. Existing content keeps its settings.

Assign, move or detach one source or project using expectedSeriesId. Moving a source does not move existing clips or change branding.

Delete the Series container at an expected revision and detach its content. Sources, projects and exports are preserved.

Create or replace a carousel project from a slide document. Server owns chip layout, safezones, and exact export pixels.

Render JPEG stills for a compiled carousel at the exact platform frame and return them as MCP images so you can inspect chips on the real slides.

Read the carousel slot document and the named template catalog.

Patch named slots or template_id on one slide. Re-rasters that slide only. Never rewrite HTML.

Reorder, remove, insert, duplicate, or undo slides on a compiled carousel. One write for the filmstrip. Insert rasters an empty named template unless sourceIndex copies a slide.

Turn a named recipe or a brief into compile-ready named-template slides. Expand never publishes and never invents metrics.

Rebuild a compile slot document from a legacy overlay carousel. Then patch slots like any compiled deck.

Duplicate a carousel onto a new project. Copies slots. Icon and shot values may be pack filenames or asset:<media_asset_id>.

Save or apply a theme, brand theme, or named slide template. Themes rewrite fonts, colors, overlay, and asset:<id> logos. Never persist signed URLs.

List Instagram accounts connected through the BlitzReels UI for the authenticated workspace, including their connection status.

Schedule a completed project export to Instagram. Optional includeAffiliateCta appends Try BlitzReels for free plus the Affonso tracking URL. Requires an active Instagram account connected in the BlitzReels UI.

Read the supported accounts available through the existing workspace and provider access rules. Does not connect new accounts, publish, schedule or bypass provider review.

Schedule a selected existing video asset to explicit active YouTube, Instagram, Facebook, TikTok, LinkedIn or Threads accounts connected in the BlitzReels UI, using reviewed copy, privacy/consent choices, synthetic-media disclosure, time and timezone. Requires confirmPublish=true. Existing workspace permissions and provider access rules apply. A scheduled receipt is not proof of publication.

Read the current targets for one publishing receipt with scheduled/published state and verified remote URLs. Does not retry or publish a failed target.