Start a video edit: a private upload link for the video, or footage from source_url

The full brief of the MCP tool edit_video: purpose, hooks, shorts (or "all"), formats, sound_effects, speaker_name, instructions (8,000 characters), asset_ids, music_staging_key, style_id/style_version, source_url, or clips to cut a long recording into clips. format: vertical/horizontal still works. Cost: 3 credits plus 1 a minute of footage, plus 3 per extra output; dry_run: true answers it first.

post/videos

Request

  • Base URL: https://clypmint.com/api/v1
  • URL: https://clypmint.com/api/v1/videos
  • Auth: HTTP bearer

Request body

operation_idstring

A stable ID for this request. Preserve it on retries. Use a new ID only for a deliberate new request.

purpose'organic' | 'ad' | 'youtube' | 'sales_page'

organic (a post), ad (three openings by default), youtube (horizontal), sales_page.

hooksinteger

Openings to make (1-3): an ad gets 3 by default, the main cut counting as one.

style_idstring

A style id from browse_styles, e.g. serif-editorial-launch, bold-navy-statement, crimson-serif-explainer, warm, luxe, brand, or a saved style of your own (my-...).

style_versioninteger
kind'talking' | 'montage'

talking: someone speaks and their words lead the cut (talking head, interview, podcast, tutorial). montage: the pictures and the music lead (sport, action, travel, events, scenery, b-roll); what people say is not followed. Leave out when unsure: Clypmint decides from the footage.

camera_sound'keep' | 'mute'

The footage's own sound. mute: only the song plays (the default for a montage with a song). keep: the camera sound stays (the default otherwise).

instructionsstring

Anything else the user asked for, in their own words, usually one or two sentences. Length, kind, song, style and formats go in their own fields, not here. Clypmint watches the footage itself: do not describe the footage, write rules or explain how to edit. Kept in full.

format'vertical' | 'horizontal'

The older one-shape switch; formats says more.

titlestring
formatsstring[]

Only when the user asked for a shape: vertical, TikTok, Reels or Shorts is 9:16; square is 1:1; 4:5; YouTube or widescreen is 16:9. Every shape to make, the main one first. Leave it out otherwise: the video keeps its own shape and nothing is cropped.

sound_effectsboolean

true: sound effects on the edit.

voice'matilda' | 'sarah' | 'jessica' | 'alice' | 'liam' | 'chris' | 'brian' | 'george' | 'roger' | 'laura' | 'charlie' | 'river' | 'will' | 'eric' | 'bella' | 'daniel' | 'lily' | 'bill' | 'adam' | 'callum' | 'harry'

The narrator for a video made from words: matilda, sarah, jessica, alice, liam, chris, brian, george, roger, laura, charlie, river, will, eric, bella, daniel, lily, bill, adam, callum, harry (sarah: calm, reassuring, health and money; alice: a clear British educator; brian: deep documentary; liam: energetic ads). Leave out to let Clypmint pick one that fits the words. "Voice: <name>" in instructions does the same.

speaker_namestring

Who is talking, spelled right, e.g. "Dr. Ana Ruiz".

speaker_companystring

The speaker's company or business, spelled exactly for this video.

namesstring[]

Exact person, company and product names to spell correctly in this video; not a lasting account rule.

spellingsobject

Explicit heard-to-correct spelling pairs for this video, for example {"KMAC":"KMAK"}.

asset_idsstring[]
asset_staging_keysstring[]
music_staging_keystring

The song for this video, from import_asset (mp3, wav or m4a): a montage's soundtrack, or music under the speech.

song_uploadboolean

true when the user has a song file but no public link to it (a song attached in Claude, a file on their computer): the private upload link asks for the video and the song together. Leave out when music_staging_key is set.

source_urlstring uri

A public https link to the footage (where links are open), instead of a file.

footage_fromstring

The video_id of a video already made from this footage: a new edit of the same footage with no new upload (another kind, length or style). To change that video itself, use revise_video or apply_edits instead.

source_duration_secondsnumber
dry_runboolean

true: answer the credit cost and start nothing.

Response

Upload link ready; editing starts when the video arrives

import_idstring nullable
video_idstring nullable
titlestring
state'waiting' | 'uploading' | 'editing' | 'ready' | 'failed' required

waiting: the private upload link is open. uploading: the video is arriving. editing: Clypmint is editing it.

progressnumber
durationnumber nullable
readyboolean required
problemstring nullable
next_stepstring

For a failed video: what to do now.

messagestring
upload_urlstring uri nullable

Open in a browser, or upload to it, to send the video. Works once, for 15 minutes.

expires_atstring date-time nullable
studio_urlstring uri
share_urlstring nullable

A public page for the video; null until Clypmint has public pages.

Changes

No recorded changes to this operation across all 1 revision of this API.