Process an Image

Submit an image containing math, text, tables, or chemistry diagrams and get back structured content as Mathpix Markdown, LaTeX, HTML, or other formats.

Send an image URL

mpxpy

from mpxpy.mathpix_client import MathpixClient
client = MathpixClient(app_id="APP_ID", app_key="APP_KEY")
image = client.image_new(
    url="https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg"
)
# Get Mathpix Markdown
print(image.mmd())
# Get line-by-line OCR data
print(image.lines_json())

cURL

curl -X POST https://api.mathpix.com/v3/text \
-H 'app_id: APP_ID' \
-H 'app_key: APP_KEY' \
-H 'Content-Type: application/json' \
--data '{"src": "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg", "math_inline_delimiters": ["$", "$"], "rm_spaces": true}'

Python

import requests, json
r = requests.post("https://api.mathpix.com/v3/text",
    json={
        "src": "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg",
        "math_inline_delimiters": ["$", "$"],
        "rm_spaces": True
    },
    headers={
        "app_id": "APP_ID",
        "app_key": "APP_KEY",
        "Content-type": "application/json"
    }
)
print(json.dumps(r.json(), indent=4, sort_keys=True))

TypeScript

const response = await fetch("https://api.mathpix.com/v3/text", {
  method: "POST",
  headers: {
    app_id: "APP_ID",
    app_key: "APP_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    src: "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg",
    math_inline_delimiters: ["$", "$"],
    rm_spaces: true,
  }),
});
const result = await response.json();
console.log(JSON.stringify(result, null, 2));

Go

body := bytes.NewBufferString(`{
    "src": "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg",
    "math_inline_delimiters": ["$", "$"],
    "rm_spaces": true
}`)
req, _ := http.NewRequest("POST", "https://api.mathpix.com/v3/text", body)
req.Header.Set("app_id", "APP_ID")
req.Header.Set("app_key", "APP_KEY")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))

Java

HttpClient client = HttpClient.newHttpClient();
String body = """
    {
      "src": "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg",
      "math_inline_delimiters": ["$", "$"],
      "rm_spaces": true
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mathpix.com/v3/text"))
    .header("app_id", "APP_ID")
    .header("app_key", "APP_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response:

{
  "auto_rotate_confidence": 0,
  "auto_rotate_degrees": 0,
  "confidence": 1,
  "confidence_rate": 1,
  "image_height": 332,
  "image_width": 850,
  "is_handwritten": true,
  "is_printed": false,
  "latex_styled": "f(x)=\\left\\{\\begin{array}{ll}\nx^{2} & \\text { if } x<0 \\\\\n2 x & \\text { if } x \\geq 0\n\\end{array}\\right.",
  "request_id": "14b53567-9f6c-4895-ab3d-e4a8ae18f9c1",
  "text": "$f(x)=\\left\\{\\begin{array}{ll}x^{2} & \\text { if } x<0 \\\\ 2 x & \\text { if } x \\geq 0\\end{array}\\right.$",
  "version": "SuperNet-109p4"
}

Send an image file

mpxpy

from mpxpy.mathpix_client import MathpixClient
client = MathpixClient(app_id="APP_ID", app_key="APP_KEY")
image = client.image_new(file_path="cases_hw.jpg")
print(image.mmd())

cURL

curl -X POST https://api.mathpix.com/v3/text \
-H 'app_id: APP_ID' \
-H 'app_key: APP_KEY' \
--form 'file=@"cases_hw.jpg"' \
--form 'options_json="{\"math_inline_delimiters\": [\"$\", \"$\"], \"rm_spaces\": true}"'

Python

import requests, json
r = requests.post("https://api.mathpix.com/v3/text",
    files={"file": open("cases_hw.jpg","rb")},
    data={
      "options_json": json.dumps({
        "math_inline_delimiters": ["$", "$"],
        "rm_spaces": True
      })
    },
    headers={
        "app_id": "APP_ID",
        "app_key": "APP_KEY"
    }
)
print(json.dumps(r.json(), indent=4, sort_keys=True))

TypeScript

import fs from "fs";
const form = new FormData();
form.append("file", new Blob([fs.readFileSync("cases_hw.jpg")]));
form.append("options_json", JSON.stringify({
  math_inline_delimiters: ["$", "$"],
  rm_spaces: true,
}));
const response = await fetch("https://api.mathpix.com/v3/text", {
  method: "POST",
  headers: { app_id: "APP_ID", app_key: "APP_KEY" },
  body: form,
});
console.log(await response.json());

Go

var buf bytes.Buffer
w := multipart.NewWriter(&buf)
fw, _ := w.CreateFormFile("file", "cases_hw.jpg")
f, _ := os.Open("cases_hw.jpg")
io.Copy(fw, f)
f.Close()
w.WriteField("options_json", `{"math_inline_delimiters":["$","$"],"rm_spaces":true}`)
w.Close()
req, _ := http.NewRequest("POST", "https://api.mathpix.com/v3/text", &buf)
req.Header.Set("app_id", "APP_ID")
req.Header.Set("app_key", "APP_KEY")
req.Header.Set("Content-Type", w.FormDataContentType())
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))

Java

HttpClient client = HttpClient.newHttpClient();
Path file = Path.of("cases_hw.jpg");
String boundary = "----FormBoundary" + System.currentTimeMillis();
String optionsJson = "{\"math_inline_delimiters\": [\"$\", \"$\"], \"rm_spaces\": true}";
byte[] fileBytes = Files.readAllBytes(file);
ByteArrayOutputStream baos = new ByteArrayOutputStream();
baos.write(("--" + boundary + "\r\nContent-Disposition: form-data; name=\"file\"; filename=\""
    + file.getFileName() + "\"\r\nContent-Type: application/octet-stream\r\n\r\n").getBytes());
baos.write(fileBytes);
baos.write(("\r\n--" + boundary + "\r\nContent-Disposition: form-data; name=\"options_json\"\r\n\r\n"
    + optionsJson + "\r\n--" + boundary + "--\r\n").getBytes());
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.mathpix.com/v3/text"))
    .header("app_id", "APP_ID")
    .header("app_key", "APP_KEY")
    .header("Content-Type", "multipart/form-data; boundary=" + boundary)
    .POST(HttpRequest.BodyPublishers.ofByteArray(baos.toByteArray()))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

note

When sending an image file, all options are sent as stringified JSON in a top-level options_json parameter.

Request data and HTML formats

Request multiple output formats in a single call:

{
  "src": "https://mathpix-ocr-examples.s3.amazonaws.com/cases_hw.jpg",
  "formats": ["text", "data", "html"],
  "data_options": {
    "include_asciimath": true,
    "include_latex": true
  }
}

Get line-by-line data

Use include_line_data to get per-line results with position contours, useful for overlaying results on the original image.

{
  "src": "https://mathpix.com/examples/text_with_diagram.png",
  "formats": ["text"],
  "include_line_data": true
}

Response:

{
  "auto_rotate_confidence": 0,
  "auto_rotate_degrees": 0,
  "confidence": 0.45044320869814447,
  "confidence_rate": 0.9904373020612357,
  "image_height": 733,
  "image_width": 932,
  "is_handwritten": false,
  "is_printed": true,
  "line_data": [
    {
      "after_hyphen": false,
      "cnt": [[62,37],[265,39],[542,45],[787,54],[860,56],[863,71],[863,85],[860,93],[784,93],[451,87],[87,76],[31,73],[0,71],[0,37]],
      "confidence": 0.45044320869814447,
      "confidence_rate": 0.9904373020612357,
      "conversion_output": true,
      "id": "74d60966b4ad49a7acf63d2c7e6cbbc6",
      "included": true,
      "is_handwritten": false,
      "is_printed": true,
      "text": "Equivalent resistance between points \\( \\mathrm{A} \\& \\mathrm{~B} \\) in the adjacent circuit is -",
      "type": "text"
    },
    {
      "cnt": [[0,687],[0,238],[656,238],[656,687]],
      "conversion_output": false,
      "error_id": "image_not_supported",
      "id": "282982c526304333b76ba533d21dd909",
      "included": false,
      "is_handwritten": false,
      "is_printed": true,
      "type": "diagram"
    }
  ],
  "request_id": "53b99d58-28d6-4ab3-a606-b94457885e73",
  "text": "Equivalent resistance between points \\( \\mathrm{A} \\& \\mathrm{~B} \\) in the adjacent circuit is -",
  "version": "SuperNet-109p4"
}

Get word-by-word data

Use include_word_data to get per-word results with position contours.

{
  "src": "https://mathpix.com/examples/text_with_math_0.jpg",
  "include_word_data": true
}

Response:

{
  "is_printed": true,
  "is_handwritten": false,
  "auto_rotate_confidence": 0.00939574267408716,
  "auto_rotate_degrees": 0,
  "word_data": [
    {
      "type": "text",
      "cnt": [[111, 104], [3, 104], [3, 74], [111, 74]],
      "text": "Perform",
      "confidence": 0.99951171875,
      "confidence_rate": 0.9999593007867263,
      "latex": "\\text { Perform }"
    },
    {
      "type": "text",
      "cnt": [[160, 104], [115, 104], [115, 74], [160, 74]],
      "text": "the",
      "confidence": 1,
      "confidence_rate": 1,
      "latex": "\\text { the }"
    },
    {
      "type": "math",
      "cnt": [[322, 191], [132, 191], [132, 110], [322, 110]],
      "text": "\\( \\frac{2 p-2}{p} \\div \\frac{4 p-4}{9 p^{2}} \\)",
      "confidence": 0.99853515625,
      "confidence_rate": 0.9999436201400773,
      "latex": "\\frac{2 p-2}{p} \\div \\frac{4 p-4}{9 p^{2}}"
    }
  ]
}

Auto rotation

Images in the wrong orientation are automatically corrected. Control this with auto_rotate_confidence_threshold (default 0.99). Set to 1 to disable.

Example of a rotated image:

After auto rotation:

What you can process

• Math equations (printed and handwritten)
• Text with math (mixed content)
• Tables (structured tabular data)
• Chemistry diagrams (returned as SMILES notation)
• Documents (multi-line content with layout)

Next steps

• POST v3/text reference — Full request parameters, response schema, and data objects
• Authentication — How to get your API keys
• Process a PDF — For multi-page documents