Uploads API

What the uploads endpoints are for

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.

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" }'

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.