Creates a new job that uses AI to generate chapters for a Mux Video asset. Optional output steering can guide chapter style, granularity, audience, and brand terms without changing the response schema.
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 generate chapters for.
BCP 47 language code of the caption track to analyze (e.g. "en", "fr"). When omitted, the SDK prefers English if available.
BCP 47 language code for the output chapter titles. Auto-detected from the transcript if omitted.
Curated output_steering controls for chapter style, granularity, audience, and brand terminology. These controls guide model behavior but do not guarantee exact output.
Best-effort style guidance for generated chapter titles.
Best-effort guidance for how coarse or fine chapter boundaries should be.
Intended audience used as best-effort model guidance. Does not change the output schema.
Preferred brand or domain terms to use when supported by the source content.
Deprecated: use output_steering. Raw prompt-section overrides; any section supplied here takes precedence over the equivalent output_steering guidance.
Override the core task instruction for chapter generation.
Override the JSON output format instructions.
Override the chapter density and timing constraints.
Override the chapter title style requirements.
When true, the generated chapters are written back to the Mux asset as a chapters text track once the job completes, making them deliverable with the asset. Overwrites existing chapters: an asset holds a single chapters track, so any chapters track already on the asset is deleted and replaced — including one in a different language, and one you created yourself. Best-effort — a failed write does not fail the job — so check asset_update in the job outputs for the outcome.
{
"parameters": {
"asset_id": "mux_asset_123abc",
"update_asset_chapters": true,
"output_steering": {
"chapter_style": "descriptive",
"chapter_granularity": "balanced",
"audience": "Developers"
}
}
}{
"data": {
"id": "rjob_example123",
"workflow": "generate-chapters",
"status": "pending",
"units_consumed": 0,
"created_at": 1700000000,
"updated_at": 1700000060,
"parameters": {
"asset_id": "mux_asset_123abc",
"update_asset_chapters": true,
"output_steering": {
"chapter_style": "descriptive",
"chapter_granularity": "balanced",
"audience": "Developers"
}
}
}
}