This endpoint returns a detailed list of results for all the items processed by a given job including the total, completed, and failed number of items.
For each item it also includes the status
, assigned engine
, startTime
, updateTime
, endTime
, and elapsedTime
.
Roles
All the roles can access this route.
Retrieving non-text results
Some models produce non-text outputs such as image, video, or audio files. In the case of large files, it becomes cumbersome to convert these files into text using something like base64 encoding, so instead, Modzy saves these results to a file and then returns the location of the file in the results response. In the example below the "results.wav"
line contains the location of the WAV file produced by Modzy's Text to Speech model.
{
"status": "SUCCESSFUL",
"engine": "model-batch-uvdncymn6q-0-0-2-7d74556c7-r9jrq",
"inputFetching": 121,
"outputUploading": null,
"modelLatency": 132,
"queueTime": 676,
"startTime": "2021-10-26T15:25:41.900+0000",
"updateTime": "2021-10-26T15:26:11.792+0000",
"endTime": "2021-10-26T15:26:11.792+0000",
"results.wav": "https://trial.app.modzy.com/api/results/197f2831-cg83-4ac2-a7d8-0e37886e88wf/user-input/results.wav\n",
"voting": {
"up": 0,
"down": 0
}
}
To retrieve this file, you simply need to submit an HTTP GET
request on this endpoint, and include an Authorization
header with your API Key. In the sample below be sure to replace the URL with the URL you receive from your model and API_KEY
with an API Key that is permitted to access this file.
curl https://trial.app.modzy.com/api/results/197f2831-cg83-4ac2-a7d8-0e37886e88wf/user-input/results.wav \
-H 'Authorization: ApiKey API_KEY' >text-to-speech-output.wav
curl https://app.modzy.com/api/results/197f2831-cg83-4ac2-a7d8-0e37886e88wf/user-input/results.wav ^
-H 'Authorization: ApiKey API_KEY' ^
--output text-to-speech-output.wav