API reference
65 endpoints across 13 groups, generated from the OpenAPI spec for MakeAIVideo API 1.2. Every endpoint uses the same bearer API key and uses the same credits and the same balance as the app.
New here? Start with the quickstart, then authentication. If you want an assistant to call these for you rather than writing the requests yourself, see the MCP server. The developer hub has the wider picture.
Introspection
Videos
Create, inspect, edit, regenerate, export and download videos.
- GET
/videosList videos - POST
/videosCreate a video from a brief or your own script - POST
/videos/estimateFree credit quote - GET
/videos/{id}Video status and progress - PATCH
/videos/{id}Edit title, topic, script or caption settings - DELETE
/videos/{id}Delete a video and its files - POST
/videos/{id}/generateStart or re-run generation (drafts, or after edits) - POST
/videos/{id}/cancelCancel a running render and release its credits - GET
/videos/{id}/downloadSigned download URL for the finished MP4 - GET
/videos/{id}/rendersPast exports - POST
/videos/{id}/rendersExport again (after edits) - GET
/videos/{id}/renders/progressCurrent export progress - POST
/videos/{id}/scenes/{n}/regenerateRegenerate one scene (optionally with new narration) - GET
/videos/{id}/voiceVoice regeneration progress - POST
/videos/{id}/voiceRegenerate the voiceover with another voice - GET
/videos/{id}/captionsCaption file (SRT or VTT), returned as text - POST
/videos/{id}/share-linkPublic, expiring link to the MP4 for people without an account - POST
/videos/{id}/reportFlag a generated video for review - POST
/videos/image-to-videoAnimate one image into a 5 or 10 s clip; optional narration makes the subject speak it (voice + lip-sync) - POST
/videos/talking-avatarYour own filmed video speaks a new script (voice + lip-sync onto your clip). For an AI presenter use POST /videos with mode talking-head - POST
/videos/character-swapCharacter Swap: the person in your video becomes a character or the person in your photos. Motion, camera, room and the original audio are kept; lips stay in sync. 3-60 s - GET
/templatesTemplate library
Scripts
Write or structure a script before rendering.
Characters
- GET
/charactersPreset and workspace characters - POST
/charactersSave a character from generated or uploaded assets - GET
/characters/{id}Character detail with signed asset URLs - PATCH
/characters/{id}Update name, description or voice - DELETE
/characters/{id}Delete a workspace character - POST
/characters/variationsGenerate 1-4 portrait candidates (spends credits) - POST
/characters/voice-previewsCandidate voices reading a sample line
Voices
Music
Uploads
- POST
/uploads/referenceUpload reference images (multipart, field `files`) - POST
/uploads/reference-from-urlImport a reference image from a public URL - POST
/uploads/video-from-urlImport a video from a public URL (MP4/MOV/WebM, up to 100 MB) for talking-avatar or character-swap - POST
/uploads/video-avatarUpload a talking video for the avatar mode (multipart, field `file`)
Brand kit
Workspace
Ideas
Publishing
Connect social accounts and post finished videos to them.
- GET
/publishing/accountsConnected social accounts, the plan's account limit, and every platform - POST
/publishing/accounts/connectLink a PERSON opens to connect one OAuth account - POST
/videos/{id}/publishPost a finished video to connected accounts, now or scheduled (async) - GET
/publishing/postsPublish history, newest first (keyset pagination) - GET
/publishing/posts/{id}One post: status and per-destination results
Webhooks
- GET
/webhooksList webhooks - POST
/webhooksCreate a webhook (secret returned once) - GET
/webhooks/{id}Webhook detail - PATCH
/webhooks/{id}Update URL, events, name, or re-enable - DELETE
/webhooks/{id}Delete a webhook - POST
/webhooks/{id}/testSend a signed test ping (data.test = true) - GET
/webhooks/{id}/deliveriesLast 50 delivery attempts
Auth
CLI device-code login (RFC 8628). Unauthenticated.
Get an API key
The API and MCP server use the same credits and the same balance as the app, with no separate API plan. Create a key under Settings, Advanced, API keys.
7-day free trial with 350 credits, then plans from $9/mo. Cancel anytime before the trial ends.