POSTPublichomework-grading

Smart Homework Grading

Upload a single K12 homework or test paper image for smart recognition, returning per-question grading conclusions, error analysis, and overall statistics to assist teachers and parents with homework checking.

Usage Cost

60 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

The Smart Homework Grading API supports automatic question recognition and answer comparison by uploading a single K12 homework or test paper image. The API can return per-question grading conclusions (e.g., correct, incorrect, partially correct), error analysis, and overall grading statistics to help quickly identify weak knowledge points.

Request and Response

When making a request, you must provide the Base64 encoding of the image (imageBase64), and you can control whether to disable image pre-processing via the disablePreprocess parameter. In the response, isAllFinished indicates whether grading is complete, status is the request status, stat_result contains statistics on the total number of questions and graded questions, and the imageResults array provides detailed per-question grading specifics.

Use Cases

Suitable for education apps, home-school interaction platforms, or smart learning hardware. It can be used by parents for quick checks when tutoring children's homework daily, or by teachers for auxiliary grading when processing student homework in batches after class, improving homework processing efficiency.

Usage Instructions and Limitations

AI grading may have misjudgments. The results are for learning and reference only. Teachers, parents, or students should manually review the results in conjunction with the specific requirements of the questions. To protect privacy, please redact or crop unnecessary personal sensitive information such as names, student IDs, and schools before uploading images, minimizing the submission of sensitive data. The Toolkk platform does not persistently store user-uploaded homework images.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "imageBase64": "/9j/4AAQSk...",
  "disablePreprocess": false
}

Response Example

{
  "isAllFinished": true,
  "status": "Success",
  "stat_result": {
    "all": 10,
    "corrected": 10
  },
  "imageResults": []
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
imageBase64	string	/9j/4AAQSk...
disablePreprocess	boolean	false

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
isAllFinished	boolean	true
status	string	Success
stat_result	object	{...}
stat_result.all	number	10
stat_result.corrected	number	10
imageResults	array	[]

curl --request POST \ --url 'https://openapi.toolkk.com/v1/homework-grading' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "imageBase64": "/9j/4AAQSk...",\n "disablePreprocess": false\n}'

import os import requests url = "https://openapi.toolkk.com/v1/homework-grading" payload = { "imageBase64": "/9j/4AAQSk...", "disablePreprocess": false } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/homework-grading" payload := []byte("{\n \"imageBase64\": \"/9j/4AAQSk...\",\n \"disablePreprocess\": false\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"imageBase64\": \"/9j/4AAQSk...\",\n \"disablePreprocess\": false\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/homework-grading")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/homework-grading'; $payload = "{\n \"imageBase64\": \"/9j/4AAQSk...\",\n \"disablePreprocess\": false\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;