Ask Questions
Create an 'ask-questions' job
Creates a new job that uses AI to answer questions about a Mux Video asset.
post/robots/v0/jobs/ask-questions
Request body
Example request
{
"parameters": {
"asset_id": "mux_asset_123abc",
"questions": [
{
"question": "Is this video about glasses?"
},
{
"question": "What is the primary subject?",
"answer_options": [
"glasses",
"watches",
"shoes",
"hats"
]
},
{
"question": "Describe the primary subject in one sentence.",
"free_form_reply": true
}
],
"max_free_form_answer_length": 300
}
}Response
Ask questions job queued
Example response
{
"data": {
"parameters": {
"asset_id": "mux_asset_123abc",
"questions": [
{
"question": "Is this video about glasses?"
},
{
"question": "What is the primary subject?",
"answer_options": [
"glasses",
"watches",
"shoes",
"hats"
]
},
{
"question": "Describe the primary subject in one sentence.",
"free_form_reply": true
}
],
"max_free_form_answer_length": 300
},
"outputs": {
"answers": [
{
"question": "Is this video about glasses?",
"answer": "no",
"confidence": 0.92,
"reasoning": "No glasses appear on screen and the narration does not mention eyewear.",
"skipped": false
},
{
"question": "What is the primary subject?",
"answer": "watches",
"confidence": 0.88,
"reasoning": "Multiple wristwatches are featured prominently throughout the video.",
"skipped": false
},
{
"question": "Describe the primary subject in one sentence.",
"answer": "A close-up showcase of luxury wristwatches arranged on a wooden display.",
"confidence": 0.86,
"reasoning": "Visual evidence shows several wristwatches displayed against a wooden backdrop with no other competing subjects.",
"skipped": false
}
]
},
"resources": {
"assets": [
{
"id": "abc123asset",
"meta": {
"title": "My Video",
"creator_id": "user123",
"external_id": "ext456"
},
"_links": {
"self": {
"href": "https://api.mux.com/video/v1/assets/abc123asset"
}
}
}
]
}
}
}