MakeAIVideo
Start trial

API reference

MakeAIVideo Uploads API

4 operations · https://app.makeaivideo.ai/api/v1

When to use the Uploads API

Not everything should be generated. These endpoints bring your own material into a render: product photos, a real person's likeness, footage you already own.

Reference images arrive either as a multipart upload on POST /uploads/reference or by URL on POST /uploads/reference-from-url, which is the easier path for an agent that already has an image address and no file on disk. POST /uploads/video-avatar takes a talking video to drive avatar mode.

Upload the asset first, then reference what comes back when you create the video. The two steps are separate calls.

Import a reference image by URL
curl -X POST https://app.makeaivideo.ai/api/v1/uploads/reference-from-url \
  -H "Authorization: Bearer $MAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "image_url": "https://example.com/product.jpg" }'
POST/uploads/referencewrite

Upload reference images (multipart, field `files`)

POST https://app.makeaivideo.ai/api/v1/uploads/reference

Responses

  • 201Uploads
POST/uploads/reference-from-urlwrite

Import a reference image from a public URL

POST https://app.makeaivideo.ai/api/v1/uploads/reference-from-url

Responses

  • 201Uploads
POST/uploads/video-from-urlwrite

Import a video from a public URL (MP4/MOV/WebM, up to 100 MB) for talking-avatar or character-swap

POST https://app.makeaivideo.ai/api/v1/uploads/video-from-url

Responses

  • 201Upload
POST/uploads/video-avatarwrite

Upload a talking video for the avatar mode (multipart, field `file`)

POST https://app.makeaivideo.ai/api/v1/uploads/video-avatar

Responses

  • 201Upload

Uploads API questions

Can I use my own product photos in a generated video?
Yes. Upload them as reference images, then reference them when you create the video so the render works from your assets rather than generated stand-ins.
Can I import an image from a URL instead of uploading a file?
Yes. POST /uploads/reference-from-url imports from any public URL, which is usually simpler for a server or an agent that has an address rather than a local file.
What is the video-avatar upload for?
It supplies a talking video that drives avatar mode, so the presenter is built from real footage you provide rather than a generated character.

MakeAIVideo API guides

  • Quickstart — the create, poll and download loop end to end.
  • Authentication — what the write scope on this page mean.
  • Agents — calling these endpoints from an autonomous agent.

Get an API key

Every plan includes API and MCP access on the same credits as the app. Create a key under Settings, Advanced, API keys.

Start 7 day free trialMakeAIVideo plans and pricing

Plans from $9 a month, with the allowance topped back up each billing month.

← Music APIBrand kit API →