For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Start buildingGet support
DocumentationAPI ReferenceChangelogDiscord
  • Voices
    • POSTCreate voice
    • GETList voices
    • DELDelete voice
  • Text-to-Speech (TTS)
    • WSSStream Input
    • STREAMText-to-Speech (Streamed JSON)
    • POSTText-to-Speech (Streamed File)
    • POSTText-to-Speech (Json)
    • POSTText-to-Speech (File)
    • POSTVoice Conversion (Streamed File)
    • STREAMVoice Conversion (Streamed JSON)
  • Speech-to-speech (EVI)
    • WSSChat
  • Expression Measurement API
      • GETList jobs
      • POSTStart inference job
      • GETGet job details
      • GETGet job predictions
      • GETGet job artifacts
      • POSTStart inference job from local file
Start buildingGet support
LogoLogo
LogoLogo
Expression Measurement APIBatch

Get job predictions

GET
https://api.hume.ai/v0/batch/jobs/:id/predictions
GET
/v0/batch/jobs/:id/predictions
$curl https://api.hume.ai/v0/batch/jobs/job_id/predictions \
>     -H "X-Hume-Api-Key: <apiKey>"
200Retrieved
1[
2  {
3    "source": {
4      "type": "url",
5      "url": "https://hume-tutorials.s3.amazonaws.com/faces.zip"
6    },
7    "results": {
8      "predictions": [
9        {
10          "file": "faces/100.jpg",
11          "models": {
12            "face": {
13              "metadata": null,
14              "grouped_predictions": [
15                {
16                  "id": "unknown",
17                  "predictions": [
18                    {
19                      "frame": 0,
20                      "time": 0,
21                      "prob": 0.9994111061096191,
22                      "box": {
23                        "x": 1187.885986328125,
24                        "y": 1397.697509765625,
25                        "w": 1401.668701171875,
26                        "h": 1961.424560546875
27                      },
28                      "emotions": [
29                        {
30                          "name": "Admiration",
31                          "score": 0.10722749680280685
32                        },
33                        {
34                          "name": "Adoration",
35                          "score": 0.06395940482616425
36                        },
37                        {
38                          "name": "Aesthetic Appreciation",
39                          "score": 0.05811462551355362
40                        },
41                        {
42                          "name": "Amusement",
43                          "score": 0.14187128841876984
44                        },
45                        {
46                          "name": "Anger",
47                          "score": 0.02804684266448021
48                        },
49                        {
50                          "name": "Anxiety",
51                          "score": 0.2713485360145569
52                        },
53                        {
54                          "name": "Awe",
55                          "score": 0.33812594413757324
56                        },
57                        {
58                          "name": "Awkwardness",
59                          "score": 0.1745193600654602
60                        },
61                        {
62                          "name": "Boredom",
63                          "score": 0.23600080609321594
64                        },
65                        {
66                          "name": "Calmness",
67                          "score": 0.18988418579101562
68                        },
69                        {
70                          "name": "Concentration",
71                          "score": 0.44288986921310425
72                        },
73                        {
74                          "name": "Confusion",
75                          "score": 0.39346569776535034
76                        },
77                        {
78                          "name": "Contemplation",
79                          "score": 0.31002455949783325
80                        },
81                        {
82                          "name": "Contempt",
83                          "score": 0.048870109021663666
84                        },
85                        {
86                          "name": "Contentment",
87                          "score": 0.0579497292637825
88                        },
89                        {
90                          "name": "Craving",
91                          "score": 0.06544201076030731
92                        },
93                        {
94                          "name": "Desire",
95                          "score": 0.05526508390903473
96                        },
97                        {
98                          "name": "Determination",
99                          "score": 0.08590991795063019
100                        },
101                        {
102                          "name": "Disappointment",
103                          "score": 0.19508258998394012
104                        },
105                        {
106                          "name": "Disgust",
107                          "score": 0.031529419124126434
108                        },
109                        {
110                          "name": "Distress",
111                          "score": 0.23210826516151428
112                        },
113                        {
114                          "name": "Doubt",
115                          "score": 0.3284550905227661
116                        },
117                        {
118                          "name": "Ecstasy",
119                          "score": 0.040716782212257385
120                        },
121                        {
122                          "name": "Embarrassment",
123                          "score": 0.1467227339744568
124                        },
125                        {
126                          "name": "Empathic Pain",
127                          "score": 0.07633581757545471
128                        },
129                        {
130                          "name": "Entrancement",
131                          "score": 0.16245244443416595
132                        },
133                        {
134                          "name": "Envy",
135                          "score": 0.03267110139131546
136                        },
137                        {
138                          "name": "Excitement",
139                          "score": 0.10656816512346268
140                        },
141                        {
142                          "name": "Fear",
143                          "score": 0.3115977346897125
144                        },
145                        {
146                          "name": "Guilt",
147                          "score": 0.11615975946187973
148                        },
149                        {
150                          "name": "Horror",
151                          "score": 0.19795553386211395
152                        },
153                        {
154                          "name": "Interest",
155                          "score": 0.3136432468891144
156                        },
157                        {
158                          "name": "Joy",
159                          "score": 0.06285581737756729
160                        },
161                        {
162                          "name": "Love",
163                          "score": 0.06339752674102783
164                        },
165                        {
166                          "name": "Nostalgia",
167                          "score": 0.05866732448339462
168                        },
169                        {
170                          "name": "Pain",
171                          "score": 0.07684041559696198
172                        },
173                        {
174                          "name": "Pride",
175                          "score": 0.026822954416275024
176                        },
177                        {
178                          "name": "Realization",
179                          "score": 0.30000734329223633
180                        },
181                        {
182                          "name": "Relief",
183                          "score": 0.04414166510105133
184                        },
185                        {
186                          "name": "Romance",
187                          "score": 0.042728863656520844
188                        },
189                        {
190                          "name": "Sadness",
191                          "score": 0.14773206412792206
192                        },
193                        {
194                          "name": "Satisfaction",
195                          "score": 0.05902980640530586
196                        },
197                        {
198                          "name": "Shame",
199                          "score": 0.08103451132774353
200                        },
201                        {
202                          "name": "Surprise (negative)",
203                          "score": 0.25518184900283813
204                        },
205                        {
206                          "name": "Surprise (positive)",
207                          "score": 0.28845661878585815
208                        },
209                        {
210                          "name": "Sympathy",
211                          "score": 0.062488824129104614
212                        },
213                        {
214                          "name": "Tiredness",
215                          "score": 0.1559651643037796
216                        },
217                        {
218                          "name": "Triumph",
219                          "score": 0.01955239288508892
220                        }
221                      ],
222                      "facs": null,
223                      "descriptions": null
224                    }
225                  ]
226                }
227              ]
228            }
229          }
230        }
231      ],
232      "errors": []
233    }
234  }
235]
Get the JSON predictions of a completed inference job.
Was this page helpful?
Previous

Get job artifacts

Next
Built with

Authentication

X-Hume-Api-Keystring
API Key authentication via header

Path parameters

idstringRequiredformat: "uuid"
The unique identifier for the job.

Response

InferenceSourcePredictResultobject