curl --request POST \
  --url 'https://api.apimart.ai/v1/uploads/images?retention_days=3' \
  --header 'Authorization: Bearer <token>' \
  --form 'file=@/path/to/reference.png'

import requests

with open("reference.png", "rb") as file:
    response = requests.post(
        "https://api.apimart.ai/v1/uploads/images?retention_days=3",
        headers={"Authorization": "Bearer <token>"},
        files={"file": file}
    )

response.raise_for_status()
result = response.json()
print(result["url"])

const input = document.querySelector('input[type="file"]');
const file = input?.files?.[0];
if (!file) throw new Error("Select a file first");

const formData = new FormData();
formData.append("file", file, file.name);

const response = await fetch("https://api.apimart.ai/v1/uploads/images?retention_days=3", {
  method: "POST",
  headers: { Authorization: "Bearer <token>" },
  body: formData
});
const result = await response.json();
if (!response.ok) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
console.log(result.url);

{
  "url": "https://cdn.example/uploads/reference.png",
  "filename": "reference.png",
  "content_type": "image/png",
  "file_type": "image",
  "bytes": 235680,
  "created_at": 1793836800,
  "retention_days": 3,
  "expires_at": 1794182400
}

{
  "error": {
    "message": "insufficient balance: uploading files requires a positive account balance, please top up",
    "type": "insufficient_user_quota"
  }
}

{
  "error": {
    "message": "image file exceeds maximum 31457280 bytes (30MB)",
    "type": "invalid_request_error"
  }
}