---
title: "MakeAIVideo Uploads API: Bring Your Own Media"
description: "Upload reference images as multipart or import them from a public URL, and upload a talking video to drive the video-avatar mode of a render."
canonical: https://makeaivideo.ai/docs/api/uploads
format: markdown
generator: makeaivideo-marketing build-time HTML→MD
---

[Documentation](/docs)v1.2

Guides

-   [Overview](/docs)
-   [Quickstart](/docs/quickstart)
-   [Authentication](/docs/authentication)
-   [Webhooks](/docs/webhooks)

Integrations

-   [MCP server](/docs/mcp)
-   [Agents](/docs/agents)
-   [CLI](/docs/cli)
-   [TypeScript SDK](/docs/sdk)

API reference

-   [All endpoints](/docs/api)
-   [Introspection](/docs/api/introspection)
-   [Videos](/docs/api/videos)
-   [Scripts](/docs/api/scripts)
-   [Characters](/docs/api/characters)
-   [Voices](/docs/api/voices)
-   [Music](/docs/api/music)
-   [Uploads](/docs/api/uploads)
-   [Brand kit](/docs/api/brand-kit)
-   [Workspace](/docs/api/workspace)
-   [Ideas](/docs/api/ideas)
-   [Publishing](/docs/api/publishing)
-   [Webhooks](/docs/api/webhooks)
-   [Auth](/docs/api/auth)

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 URLCopy

```
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/reference`](/docs/api/uploads/upload-reference)
-   [POST`/uploads/reference-from-url`](/docs/api/uploads/upload-reference-from-url)
-   [POST`/uploads/video-from-url`](/docs/api/uploads/upload-video-from-url)
-   [POST`/uploads/video-avatar`](/docs/api/uploads/upload-video-avatar)

POST`/uploads/reference`write

### Upload reference images (multipart, field \`files\`)

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

#### Responses

-   `201`Uploads

POST`/uploads/reference-from-url`write

### Import a reference image from a public URL

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

#### Responses

-   `201`Uploads

POST`/uploads/video-from-url`write

### 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

-   `201`Upload

POST`/uploads/video-avatar`write

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

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

#### Responses

-   `201`Upload

## 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](/docs/quickstart) — the create, poll and download loop end to end.
-   [Authentication](/docs/authentication) — what the write scope on this page mean.
-   [Agents](/docs/agents) — calling these endpoints from an autonomous agent.

## More MakeAIVideo documentation

In the product

-   [Image to video](/image-to-video): what reference images feed
-   [Image to video](/image-to-video): the same job in the app

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.

[Start 7 day free trial](https://app.makeaivideo.ai/signup?utm_source=docs&utm_medium=docs_cta&utm_content=%2Fdocs%2Fapi%2Fuploads)[MakeAIVideo plans and pricing](/pricing)

7-day free trial with 350 credits, then plans from $9/mo. Cancel anytime before the trial ends.

[← Music API](/docs/api/music)[Brand kit API →](/docs/api/brand-kit)
