What can an assignment be marked against?
One of two things, and you pick when you set the assignment up.Model answers
Upload the answer key as a PDF or PNG photographs. The AI reads the expected answer for each question, with the marks for each step of it, so a student who gets the method right but the answer wrong can still earn part of the marks.
A rubric
Attach a rubric instead of an answer key. A rubric is a list of criteria, each with a score range and a description of what earns each band, for example “4 to 5: explains the idea in their own words with an example”.
Which subjects can an assignment cover?
There is no subject setting, and this is the product’s biggest limit. Every assignment goes to the marking AI with a fixed subject and curriculum, English on the NCERT syllabus, whatever the work actually is. An assignment record has no subject field at all, so sending one changes nothing. The grade is the one class detail that is passed through. If you leave it blank, the work is marked as grade 10.What can students submit?
You cannot mix a PDF with images on the same answer sheet, and you cannot send files and an audio link in the same request.
An audio answer only works if the assignment’s model answer sheet has a rubric attached. Without one the API refuses it, because there is nothing to score the recording against.
What comes back for each question?
The whole assignment is returned in one response, grouped by question, so you get the student’s answer next to the question and the expected answer.
How does a rubric work?
You build a rubric once and reuse it across assignments.
Criteria can also be created on their own and then linked to several rubrics, which saves rewriting a criterion such as “spoken fluency” for every subject.
What are the limits?
Assignment Evaluation does not accept video, and it does not identify who is speaking in a recording.
What does it not do that Exam Evaluation does?
Worth knowing before you choose:Frequently asked questions
Can I use a model answer and a rubric together?
Can I use a model answer and a rubric together?
You attach one or the other. If you attach a rubric, the rubric is what the AI scores against.
Can a teacher change a mark after the AI has scored it?
Can a teacher change a mark after the AI has scored it?
Not through the API. Assignment Evaluation has no endpoint for editing a score and no approval flag. If a teacher has to sign marks off, use Exam Evaluation instead.
Why was my audio link refused?
Why was my audio link refused?
The link has to use HTTPS, end in
.mp3 in the address itself rather than only in a query string, be reachable from the public internet, and not point at a private or local address. A maximum recording length may also apply. It is one server-wide setting rather than a per-account one, and when it is switched off no length is checked at all, so ask CrazyGoldFish what it is rather than relying on it. Check the error message, which names the specific reason.Can students record a video instead?
Can students record a video instead?
No. Audio only, as an MP3 file at a public HTTPS address. Convert the recording to MP3 and host it somewhere reachable before you send the link.
Can I change the questions after answer sheets have been uploaded?
Can I change the questions after answer sheets have been uploaded?
Once an assignment has been processed, sending it for processing again returns an error saying it is already extracted. Create a new assignment if the question set changes.
Why can I not upload answer sheets yet?
Why can I not upload answer sheets yet?
Both the assignment and its model answer sheet have to be fully processed first. Until then, creating an answer sheet returns an error saying the assignment or the model answer sheet is not extracted yet.
Next steps
How it works
The full flow from question set to scores.
Use cases
How schools and platforms use assignment evaluation.
Developer guide
Evaluate an assignment with the API, step by step.
Create a rubric
Build a rubric and its criteria with the API.