MakeAIVideo

MakeAIVideo API

Public v1 API for MakeAIVideo: turn a brief or your own script into a finished short-form video (script, voiceover, AI or stock scenes, captions, music), edit…

Media & content#video

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Public v1 API for MakeAIVideo: turn a brief or your own script into a finished short-form video (script, voiceover, AI or stock scenes, captions, music), edit and regenerate parts of it, and fetch the MP4. Everything the product can do, agents can do.

Authentication

All endpoints except the device-login pair accept an API key:

Authorization: Bearer mav_...

Create keys under Settings, Advanced, API keys, or with makeaivideo login (CLI device flow). Keys carry scopes (read, write, ai); each operation lists its scope under x-scope. read lists and inspects; write creates, edits, regenerates, deletes (and spends credits); ai covers generation helpers (scripts, ideas, portraits, previews, music). A missing scope returns 403 forbidden.

Envelope

Every JSON response is { data, error, meta }. On failure data is null and error is { message, code, retryable, details? }. retryable is true only for 5xx and 429; never retry a 4xx without changing the request. Two endpoints return files instead of JSON: GET /videos/{id}/captions.

The core loop

  1. GET /tools (what we can make). 2. POST /videos/estimate (free quote). 3. POST /videos with tool + fields, or with your own script (202, video_id). 4. Poll GET /videos/{id} respecting poll_after_seconds, or subscribe to video.ready with POST /webhooks. 5. GET /videos/{id}/download.

Renders take minutes. Set idempotency_key on create so a retry never produces (and charges for) a second video.

Publishing to social accounts

Post finished videos to the workspace's connected accounts: TikTok, Instagram (as a Reel), YouTube (9:16 as a Short, 16:9 as a regular video), Facebook Pages, LinkedIn, X (videos up to 140 seconds), Threads, Pinterest, Bluesky, Telegram and Discord.

  1. GET /publishing/accounts lists connected accounts (acc_... ids, can_post, needs_reconnection), the plan's account limit and every platform. 2. To add an OAuth account, POST /publishing/accounts/connect returns a short-lived url that a PERSON must open in a browser and approve; an agent cannot complete it. Bluesky, Telegram and Discord connect with credentials in the web app only (the Accounts page). 3. POST /videos/{id}/publish with account_ids and caption answers 202 with a post (pub_...); set idempotency_key so a retry never posts twice. 4. Poll GET /publishing/posts/{id} until done is true, or subscribe to post.published, post.partially_failed and post.failed. Each destination carries its own status, live url and error.

A workspace where publishing is not switched on gets 403 publishing_unavailable (not retryable).

Webhooks

POST /webhooks with a public https URL and events. Every delivery is signed: X-MakeAIVideo-Signature: sha256= , with X-MakeAIVideo-Event, X-MakeAIVideo-Event-Id (dedup key), X-MakeAIVideo-Timestamp and X-MakeAIVideo-Attempt. Non-2xx responses retry at 30s, 2m, 10m, 1h, 6h, then stop. Twenty consecutive failures disable the webhook until you PATCH is_active: true.
Events: video.created, video.ready, video.failed, character.created, and for publishing post.published (every destination went out), post.partially_failed and post.failed. A post.* event's data is the same Post object GET /publishing/posts/{id} returns. A post can emit a second outcome if a failed destination is retried later.

Endpoints 65

Introspection

  • GETWho am I/me
  • GETCredit balance/credits
  • GETList create tools and their brief fields/tools

Videos

  • GETList videos/videos
  • POSTCreate a video from a brief or your own script/videos
  • POSTFree credit quote/videos/estimate
  • GETVideo status and progress/videos/:id
  • DELETEDelete a video and its files/videos/:id
  • PATCHEdit title, topic, script or caption settings/videos/:id
  • POSTStart or re-run generation (drafts, or after edits)/videos/:id/generate
  • POSTCancel a running render and release its credits/videos/:id/cancel
  • GETSigned download URL for the finished MP4/videos/:id/download
  • GETPast exports/videos/:id/renders
  • POSTExport again (after edits)/videos/:id/renders
  • GETCurrent export progress/videos/:id/renders/progress
  • POSTRegenerate one scene (optionally with new narration)/videos/:id/scenes/:n/regenerate
  • GETVoice regeneration progress/videos/:id/voice
  • POSTRegenerate the voiceover with another voice/videos/:id/voice
  • GETCaption file (SRT or VTT), returned as text/videos/:id/captions
  • POSTPublic, expiring link to the MP4 for people without an account/videos/:id/share-link
  • POSTFlag a generated video for review/videos/:id/report
  • POSTAnimate one image into a 5 or 10 s clip; optional narration makes the subject speak it (voice + lip-sync)/videos/image-to-video
  • POSTYour own filmed video speaks a new script (voice + lip-sync onto your clip). For an AI presenter use POST /videos with mode talking-head/videos/talking-avatar
  • POSTCharacter 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/videos/character-swap
  • GETTemplate library/templates

Scripts

  • POSTWrite a script from a topic or a brief (no video yet)/videos/script
  • POSTStructure your own prose into a scene script/videos/scriptify
  • POSTFetch a public article's readable text (for the article tool)/videos/fetch-url

Characters

  • GETPreset and workspace characters/characters
  • POSTSave a character from generated or uploaded assets/characters
  • GETCharacter detail with signed asset URLs/characters/:id
  • DELETEDelete a workspace character/characters/:id
  • PATCHUpdate name, description or voice/characters/:id
  • POSTGenerate 1-4 portrait candidates (spends credits)/characters/variations
  • POSTCandidate voices reading a sample line/characters/voice-previews

Voices

  • GETVoice catalog plus curated picks/voices
  • POSTHear any voice say your text (1-hour audio URL)/voices/preview
  • GETStock sample line for a picker voice/voices/:id/preview

Music

  • GETYour generated background tracks/music
  • POSTGenerate a background track from a prompt/music

Uploads

  • POSTUpload reference images (multipart, field `files`)/uploads/reference
  • POSTImport a reference image from a public URL/uploads/reference-from-url
  • POSTImport a video from a public URL (MP4/MOV/WebM, up to 100 MB) for talking-avatar or character-swap/uploads/video-from-url
  • POSTUpload a talking video for the avatar mode (multipart, field `file`)/uploads/video-avatar

Brand kit

  • GETWatermark settings/brand-kit
  • PATCHToggle or remove the watermark/brand-kit
  • POSTUpload a watermark image (multipart, field `file`)/brand-kit/watermark

Workspace

  • GETThe workspace this key works in/workspace
  • PATCHUpdate workspace defaults/workspace

Ideas

  • POSTScored video ideas for a niche/ideas
  • POSTRewrite a rough topic into a stronger brief/ai/enhance-prompt

Publishing

  • GETConnected social accounts, the plan's account limit, and every platform/publishing/accounts
  • POSTLink a PERSON opens to connect one OAuth account/publishing/accounts/connect
  • POSTPost a finished video to connected accounts, now or scheduled (async)/videos/:id/publish
  • GETPublish history, newest first (keyset pagination)/publishing/posts
  • GETOne post: status and per-destination results/publishing/posts/:id

Webhooks

  • GETList webhooks/webhooks
  • POSTCreate a webhook (secret returned once)/webhooks
  • GETWebhook detail/webhooks/:id
  • DELETEDelete a webhook/webhooks/:id
  • PATCHUpdate URL, events, name, or re-enable/webhooks/:id
  • POSTSend a signed test ping (data.test = true)/webhooks/:id/test
  • GETLast 50 delivery attempts/webhooks/:id/deliveries

Auth

  • POSTStart a device login/auth/device
  • POSTPoll a device login; receives the key once/auth/device/token

API details

Base URL
https://app.makeaivideo.ai/api/v1
Authentication
A bearer token in the Authorization header
Operations
65 operations on 51 pathsPOST 33GET 24PATCH 5DELETE 3
Main resources
Videos 22Characters 7Webhooks 7Publishing 5Uploads 4Brand kit 3Introspection 3Scripts 3Voices 3Auth 2
Response formats
application/json application/x-subrip text/vtt
Description format
OpenAPI 3.1.0, API version 1.2

How to test the MakeAIVideo API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the MakeAIVideo API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Who am I” (GET /me), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the MakeAIVideo API?

Public v1 API for MakeAIVideo: turn a brief or your own script into a finished short-form video (script, voiceover, AI or stock scenes, captions, music), edit… It is listed under Media & content and has 65 endpoints.

Who publishes the MakeAIVideo API?

It is listed from MakeAIVideo's public API description (an OpenAPI document), not published by MakeAIVideo on Swastik Codes. Anyone who controls makeaivideo.ai can claim the profile by adding a DNS TXT record.

What is the base URL of the MakeAIVideo API?

Requests go to https://app.makeaivideo.ai/api/v1. Endpoint paths are added to this base URL.

How do I authenticate with the MakeAIVideo API?

With A bearer token in the Authorization header.

How many endpoints does the MakeAIVideo API have?

65 operations on 51 paths (33 POST, 24 GET, 5 PATCH, 3 DELETE). The largest groups are Videos, Characters, Webhooks, Publishing.

Is forking the MakeAIVideo API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.