Batch

List jobs

GET
Sort and filter jobs.

Query parameters

limitintegerOptional
The maximum number of jobs to include in the response.
statusenumOptional
Include only jobs with these statuses.
whenenumOptional

Include only jobs that were created before or after timestamp_ms.

timestamp_msintegerOptional

Defaults to the current date and time. See when.

sort_byenumOptional
The job timestamp to sort by.
directionenumOptional
The sort direction.
typeenumOptional
Include only jobs of these types.

Response

This endpoint returns a list of unions
EMBEDDING GENERATION
OR
INFERENCE
OR
TL INFERENCE
OR
TRAINING
GET
$curl https://api.hume.ai/v0/batch/jobs \
> -H "X-Hume-Api-Key: <apiKey>"
Response
1[
2 {
3 "type": "INFERENCE",
4 "job_id": "job_id",
5 "request": {
6 "files": [
7 {
8 "md5sum": "md5sum",
9 "filename": "filename",
10 "content_type": "content_type"
11 }
12 ],
13 "models": {
14 "face": {
15 "fps_pred": 3,
16 "prob_threshold": 0.99,
17 "identify_faces": false,
18 "min_face_size": 60,
19 "facs": null,
20 "descriptions": null,
21 "save_faces": false
22 },
23 "burst": {},
24 "prosody": {
25 "granularity": "utterance",
26 "window": null,
27 "identify_speakers": false
28 },
29 "language": {
30 "granularity": "word",
31 "sentiment": null,
32 "toxicity": null,
33 "identify_speakers": false
34 },
35 "ner": {
36 "identify_speakers": false
37 },
38 "facemesh": {}
39 },
40 "urls": [
41 "https://hume-tutorials.s3.amazonaws.com/faces.zip"
42 ],
43 "registry_files": [],
44 "text": [],
45 "callback_url": null,
46 "notify": true
47 },
48 "state": {
49 "status": "COMPLETED",
50 "created_timestamp_ms": 1712587158717,
51 "ended_timestamp_ms": 1712587159274,
52 "num_errors": 0,
53 "num_predictions": 10,
54 "started_timestamp_ms": 1712587158800
55 },
56 "user_id": "user_id"
57 }
58]