Creates a new job that uses AI to answer questions about a Mux Video asset. Optional output steering can restrict execution to a time scope in seconds.
Arbitrary string stored with the job and returned in responses. Useful for correlating jobs with your own systems.
The Mux asset ID of the video to analyze.
One or more questions to ask about the video, up to 50. Each question can either select from answer_options (defaults to yes/no) or, by setting free_form_reply: true, receive a free-form prose answer.
The question to ask about the video content. Maximum 600 characters.
Allowed answer values for this question. Defaults to ["yes", "no"] when omitted and free_form_reply is not true. Mutually exclusive with free_form_reply. Each option is a short label of at most 150 characters.
When true, the model replies with free-form prose instead of selecting from answer_options. Mutually exclusive with answer_options. Treat the answer as untrusted model output.
BCP 47 language code of the caption source. An explicit language must match a ready source exactly, including case; for example, en does not match en-US. Translation target exclusion and track replacement instead compare base languages case-insensitively. When omitted, automatic selection applies. Uses the first ready subtitle in asset track order without English preference. Audio-only assets with one ready text track lacking subtitle metadata can use that legacy transcript.
Max character length for free-form answers, between 1 and 1000. Ignored unless at least one question sets free_form_reply: true.
Curated controls that optionally restrict question answering to an asset time range.
{
"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,
"output_steering": {
"scope": {
"start_time": 30,
"end_time": 180
}
}
}
}{
"data": {
"id": "rjob_example123",
"workflow": "ask-questions",
"status": "pending",
"units_consumed": 0,
"created_at": 1700000000,
"updated_at": 1700000060,
"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,
"output_steering": {
"scope": {
"start_time": 30,
"end_time": 180
}
}
}
}
}