Upload Image

Upload Image from File

curl --request POST \
  --url https://api.memories.ai/serve/api/v1/upload_img \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'datetime_taken=2025-09-07 22:52:00' \
  --form 'camera_model=Canon EOS 5D' \
  --form latitude=39.9042 \
  --form longitude=116.4074 \
  --form 'tags[0]=test1' \
  --form 'tags[1]=test2' \
  --form files.items='@example-file'

import requests

url = "https://api.memories.ai/serve/api/v1/upload_img"

files = { "files.items": ("example-file", open("example-file", "rb")) }
payload = {
    "files": "<string>",
    "datetime_taken": "2025-09-07 22:52:00",
    "camera_model": "Canon EOS 5D",
    "latitude": "39.9042",
    "longitude": "116.4074",
    "tags[0]": "test1",
    "tags[1]": "test2"
}
headers = {"Authorization": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('files', '<string>');
form.append('datetime_taken', '2025-09-07 22:52:00');
form.append('camera_model', 'Canon EOS 5D');
form.append('latitude', '39.9042');
form.append('longitude', '116.4074');
form.append('tags[0]', 'test1');
form.append('tags[1]', 'test2');
form.append('files.items', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.memories.ai/serve/api/v1/upload_img', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/upload_img",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/upload_img"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.memories.ai/serve/api/v1/upload_img")
  .header("Authorization", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/upload_img")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "id": 568102998803353600
    },
    {
      "id": 568102998803353600
    }
  ],
  "success": true,
  "failed": false
}

POST

serve

api

upload_img

Upload Image from File

curl --request POST \
  --url https://api.memories.ai/serve/api/v1/upload_img \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'datetime_taken=2025-09-07 22:52:00' \
  --form 'camera_model=Canon EOS 5D' \
  --form latitude=39.9042 \
  --form longitude=116.4074 \
  --form 'tags[0]=test1' \
  --form 'tags[1]=test2' \
  --form files.items='@example-file'

import requests

url = "https://api.memories.ai/serve/api/v1/upload_img"

files = { "files.items": ("example-file", open("example-file", "rb")) }
payload = {
    "files": "<string>",
    "datetime_taken": "2025-09-07 22:52:00",
    "camera_model": "Canon EOS 5D",
    "latitude": "39.9042",
    "longitude": "116.4074",
    "tags[0]": "test1",
    "tags[1]": "test2"
}
headers = {"Authorization": "<api-key>"}

response = requests.post(url, data=payload, files=files, headers=headers)

print(response.text)

const form = new FormData();
form.append('files', '<string>');
form.append('datetime_taken', '2025-09-07 22:52:00');
form.append('camera_model', 'Canon EOS 5D');
form.append('latitude', '39.9042');
form.append('longitude', '116.4074');
form.append('tags[0]', 'test1');
form.append('tags[1]', 'test2');
form.append('files.items', '{
  "fileName": "example-file"
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.memories.ai/serve/api/v1/upload_img', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.memories.ai/serve/api/v1/upload_img",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.memories.ai/serve/api/v1/upload_img"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.memories.ai/serve/api/v1/upload_img")
  .header("Authorization", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.memories.ai/serve/api/v1/upload_img")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files\"\r\n\r\n<string>\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"datetime_taken\"\r\n\r\n2025-09-07 22:52:00\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"camera_model\"\r\n\r\nCanon EOS 5D\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"latitude\"\r\n\r\n39.9042\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"longitude\"\r\n\r\n116.4074\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B0%5D\"\r\n\r\ntest1\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"tags%5B1%5D\"\r\n\r\ntest2\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"files.items\"; filename=\"example-file\"\r\nContent-Type: application/octet-stream\r\n\r\n{\r\n  \"fileName\": \"example-file\"\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "id": 568102998803353600
    },
    {
      "id": 568102998803353600
    }
  ],
  "success": true,
  "failed": false
}

Product: Visual Search Use case: Upload videos and images, auto-index them, then search by natural language, image, or transcript phrase Host: https://api.memories.ai/serve/api/v1 Auth: Authorization: sk-mavi-... (no Bearer prefix)

Uploaded images go into your Private Image Library — this is a separate library from your Private Video Library. Use Upload Video if you want to add videos. Once uploaded, images are indexed automatically and become searchable via Search Private Image Library.

Prerequisites

You have created a memories.ai API key.
Supported formats: .jpg, .jpeg, .png, .gif, .bmp, .webp (case-insensitive). The Content-Type of each file part must start with image/.
Max file size: 20 MB per image.

Endpoint

POST https://api.memories.ai/serve/api/v1/upload_img

This endpoint uses multipart/form-data. Repeat the files field once per image. All other parameters are sent as form fields.

Authentication

Authorization: sk-mavi-...

Request Example

import requests

headers = {"Authorization": "sk-mavi-..."}
files = [
    ("files", ("photo1.jpg", open("photo1.jpg", "rb"), "image/jpeg")),
    ("files", ("photo2.png", open("photo2.png", "rb"), "image/png")),
]
data = {
    "datetime_taken": "2025-09-07 22:52:00",
    "camera_model": "Canon EOS 5D",
    "latitude": "39.9042",
    "longitude": "116.4074",
    "tags": ["outdoor", "2025"]
}
response = requests.post(
    "https://api.memories.ai/serve/api/v1/upload_img",
    headers=headers,
    files=files,
    data=data
)
print(response.json())

Request Parameters

files

file[]

required

One or more image files. Each must have a supported extension and a Content-Type starting with image/. Maximum 20 MB per file. If any file in the batch fails validation, the entire request is rejected.

datetime_taken

string

Capture time in yyyy-MM-dd HH:mm:ss format. Invalid formats are rejected.

camera_model

string

Camera or device model name. Maximum 200 characters.

latitude

number

GPS latitude where the images were captured (decimal).

longitude

number

GPS longitude where the images were captured (decimal).

Notes & Limits

Rate limiting: Exceeding the per-account upload rate limit returns an error. See Rate limits.
Billing: Each upload deducts credits from your account. Insufficient balance causes the request to fail.
Batch validation: If any file in the batch fails validation, the entire request is rejected — no files are uploaded.

Response Example

{
    "code": "0000",
    "msg": "success",
    "data": [
        { "id": 568102998803353601 },
        { "id": 568102998803353602 }
    ],
    "success": true,
    "failed": false
}

Response Fields

code

string

Business status code. 0000 indicates success.

msg

string

Human-readable status message.

data

array

Array of uploaded image entries, in the same order as the files parts in the request.

data[].id

integer

Unique numeric identifier for the uploaded image. Use this in subsequent search and retrieval operations.

Authorizations

Authorization

string

header

required

Body

multipart/form-data

files

file[]

required

One or more image files. Allowed extensions: .jpg, .jpeg, .png, .gif, .bmp, .webp. Content-Type must start with image/. Max 20 MB per file. Batch size capped by server configuration.

datetime_taken

string

Capture time in format yyyy-MM-dd HH:mm:ss.

Example:

"2025-09-07 22:52:00"

camera_model

string

Camera/device model. Max 200 characters.

Maximum string length: 200

Example:

"Canon EOS 5D"

latitude

number<double>

Example:

39.9042

longitude

number<double>

Example:

116.4074

Response

200 - application/json

Successful response

code

string

Business status code. 0000 indicates success.

Example:

"0000"

msg

string

Example:

"success"

data

object[]

Show child attributes

Example:

[
  { "id": 568102998803353600 },
  { "id": 568102998803353600 }
]

success

boolean

Example:

true

failed

boolean

Example:

false

Import from Hashtag — Public Overview

Get Started

Index Upload

Search

Library Management

Folder Management

Reference

Prerequisites

Endpoint

Authentication

Request Example

Request Parameters

Notes & Limits

Response Example

Response Fields

Authorizations

Body

Response

​Prerequisites

​Endpoint

​Authentication

​Request Example

​Request Parameters

​Notes & Limits

​Response Example

​Response Fields

Authorizations

Body

Response

Prerequisites

Endpoint

Authentication

Request Example

Request Parameters

Notes & Limits

Response Example

Response Fields