Every call is authenticated as your API account, not as a teacher or a student. The API accepts an upload, a mark correction, or a publish from your platform and does not ask who is behind it, so your platform decides which of its users may do each of those things. Where this page says “a teacher”, read it as “a call your platform makes on a teacher’s behalf”.
What are the two products?
Exam Evaluation
For tests and exams. Marks can be corrected, results are published in two stages, and students can raise a query on any score.
Assignment Evaluation
For English work and for anything you judge against a rubric. Faster to set up and accepts a spoken answer as an audio recording. It has no subject setting.
Which one should I use?
Use Exam Evaluation when you need to choose the subject, correct marks, and control when a result is released. Use Assignment Evaluation for English work or rubric-scored work where speed matters: scores are readable as soon as the AI finishes, and there is nothing to edit or publish.
A rubric is a list of criteria with a score band and a description for each band, for example “4 to 5: explains the idea in their own words with an example”. Model answers are the answers you would expect for each question, with the marks for each step.
What can students submit?
Both products accept a PDF or photographs of a handwritten answer sheet, but the accepted file types differ between them.The readability check has gaps worth planning around. It is skipped for a Word file, and skipped entirely for anything sent as a link, so a linked PDF is checked for neither readability, size, nor page count. If you send work by link or as a Word file, check it yourself first.
How does my platform connect to it?
Through the REST API. Your developers create the exam or assignment, upload the files, and read the scores back as JSON. The AI work runs in the background, so you either check the status or register a webhook and get told when each step finishes. You can also hand a student a hosted upload screen instead of building one. Note that it shows the marks as soon as marking finishes. See Answer sheet upload link.Frequently asked questions
Does it read handwriting?
Does it read handwriting?
Yes. That is the main use. Students photograph or scan their answer sheets and the AI reads the handwriting. It also writes a description of any diagram it finds, so the diagram can be marked.
Can students submit audio or video?
Can students submit audio or video?
An assignment answer can be an audio recording, given as a public HTTPS link to an MP3 file. The assignment must have a rubric attached for this to work. Exams do not accept audio, and neither product accepts video.
Does a teacher have to approve the scores?
Does a teacher have to approve the scores?
Nothing in the API requires it. For exams, marks can be corrected at any point, and publishing opens the two result endpoints. But a third endpoint returns the same marks and feedback with no publishing check, and the API cannot tell a student’s request from a teacher’s, so an approval step is something your platform enforces, not something the API guarantees. For assignments there is no approval or publishing step at all, so scores are readable as soon as the AI finishes.
Which grades and subjects are supported?
Which grades and subjects are supported?
Exams cover grades 1 to 12 and CA Foundation. The subject is not picked from a fixed list: your developers name it when they create the exam, in English, Hindi, or another language. Subjects it has been used for include science, maths, English, Hindi, social studies, and several commerce and Rajasthan board subjects.Assignments are different. There is no subject setting at all: every assignment is marked as English on the NCERT syllabus, whatever the work is. The grade is passed through, and defaults to grade 10 if you leave it blank. Use a rubric if the work is not English, or use Exam Evaluation where you choose the subject.
Do results flow into the other CrazyGoldFish products automatically?
Do results flow into the other CrazyGoldFish products automatically?
No. Nothing is passed on by itself. Scores and feedback are returned to you through the API, and your platform decides what to do with them.
Is there a limit on how much I can send?
Is there a limit on how much I can send?
Yes, and the details are fiddly. Papers and answer sheets sent for marking are capped per day, counted per API user rather than per account, so two of your users each get their own allowance. The refusal code differs by call: sending a question paper or an assignment for reading is refused with a
400, and sending an answer sheet for marking is refused with a 429. Audio answers have their own tighter cap, a few in any 60 second window, also a 429. Sending model answers is not limited at all. Ask CrazyGoldFish for your numbers, and read the message in the response, which states the limit it hit.Next steps
Exam Evaluation features
What the AI marks, what a teacher controls, and how results are published.
Assignment Evaluation features
Rubrics, audio answers, and what comes back for each question.
Evaluate an exam
The developer guide, step by step.
Evaluate an assignment
The developer guide, step by step.