Upload File

curl --request POST \
  --url https://api.muvi.video/v1/uploads/presign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>",
  "contentType": "<string>"
}
'

import requests

url = "https://api.muvi.video/v1/uploads/presign"

payload = {
    "filename": "<string>",
    "contentType": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filename: '<string>', contentType: '<string>'})
};

fetch('https://api.muvi.video/v1/uploads/presign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "uploadUrl": "<string>",
  "fileUrl": "<string>",
  "fileId": "<string>",
  "expiresAt": "<string>",
  "maxSize": 123
}

POST

uploads

presign

Upload File

curl --request POST \
  --url https://api.muvi.video/v1/uploads/presign \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filename": "<string>",
  "contentType": "<string>"
}
'

import requests

url = "https://api.muvi.video/v1/uploads/presign"

payload = {
    "filename": "<string>",
    "contentType": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({filename: '<string>', contentType: '<string>'})
};

fetch('https://api.muvi.video/v1/uploads/presign', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "uploadUrl": "<string>",
  "fileUrl": "<string>",
  "fileId": "<string>",
  "expiresAt": "<string>",
  "maxSize": 123
}

Authentication

This endpoint requires an API key.

Authorization: Bearer YOUR_API_KEY

Request Body

string

required

Name of the file to upload. Example: "my-image.png"

string

required

MIME type of the file. Allowed types: image/jpeg, image/png, image/webp, image/gif, video/mp4, video/webm, audio/mpeg, audio/wav.

Response

string

Presigned PUT URL. Upload your file here with a PUT request within 15 minutes.

string

CDN URL where the file will be accessible after upload. Use this URL in job inputs.

string

Unique identifier for the upload. Use to check status.

string

ISO 8601 timestamp when the file will be automatically deleted (60 minutes from creation).

number

Maximum allowed file size in bytes. Images: 10MB, Videos: 100MB, Audio: 50MB.

How It Works

Call this endpoint to get a presigned upload URL
Upload your file via PUT to the uploadUrl (include Content-Type header)
Use the fileUrl in your job submission input
File is automatically deleted after 60 minutes

Error Codes

Code	Description
`VALIDATION_ERROR`	Missing or invalid filename/contentType.
`INVALID_CONTENT_TYPE`	Content type not in the allowed list.

Examples

# Step 1: Get presigned URL
curl -X POST https://api.muvi.video/v1/uploads/presign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "my-image.png",
    "contentType": "image/png"
  }'

# Step 2: Upload file to the presigned URL
curl -X PUT "UPLOAD_URL_FROM_RESPONSE" \
  -H "Content-Type: image/png" \
  --data-binary "@my-image.png"

# Step 3: Use fileUrl in job submission
curl -X POST https://api.muvi.video/v1/jobs/submit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro/edit-image",
    "input": {
      "image": "FILE_URL_FROM_RESPONSE",
      "prompt": "Add a sunset background"
    }
  }'

import requests

# Step 1: Get presigned URL
response = requests.post(
    "https://api.muvi.video/v1/uploads/presign",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "filename": "my-image.png",
        "contentType": "image/png"
    }
)

data = response.json()["data"]
print(f"File URL: {data['fileUrl']}")
print(f"Expires at: {data['expiresAt']}")

# Step 2: Upload file
with open("my-image.png", "rb") as f:
    requests.put(
        data["uploadUrl"],
        headers={"Content-Type": "image/png"},
        data=f
    )

# Step 3: Use in job submission
job = requests.post(
    "https://api.muvi.video/v1/jobs/submit",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "model": "google/nano-banana-pro/edit-image",
        "input": {
            "image": data["fileUrl"],
            "prompt": "Add a sunset background"
        }
    }
)

// Step 1: Get presigned URL
const response = await fetch("https://api.muvi.video/v1/uploads/presign", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    filename: "my-image.png",
    contentType: "image/png"
  })
});

const { data } = await response.json();
console.log(`File URL: ${data.fileUrl}`);

// Step 2: Upload file
const file = await fs.readFile("my-image.png");
await fetch(data.uploadUrl, {
  method: "PUT",
  headers: { "Content-Type": "image/png" },
  body: file
});

// Step 3: Use in job submission
const job = await fetch("https://api.muvi.video/v1/jobs/submit", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "google/nano-banana-pro/edit-image",
    input: {
      image: data.fileUrl,
      prompt: "Add a sunset background"
    }
  })
});

Example Response

{
  "success": true,
  "data": {
    "uploadUrl": "https://storage.muvi.video/temp/...",
    "fileUrl": "https://assetsv1.cdn.muvi.video/temp/user_abc123/uuid_my-image.png",
    "fileId": "3f44e3c6-acd9-4cc3-a91b-e63ec517b383",
    "expiresAt": "2026-02-25T11:42:21.949Z",
    "maxSize": 10485760
  },
  "requestId": "req_abc123"
}

Task Management

Models

Providers

File Uploads

Catalog

Upload File

Authentication

Request Body

Response

How It Works

Error Codes

Examples

Example Response

​Authentication

​Request Body

​Response

​How It Works

​Error Codes

​Examples

​Example Response

Authentication

Request Body

Response

How It Works

Error Codes

Examples

Example Response