---
title: "Plan independent short highlights from a timed transcript (account/root API key only)"
method: POST
path: "/auto-edit"
---

# Plan independent short highlights from a timed transcript (account/root API key only)

`POST /auto-edit`

## Request

- Base URL: `https://api.justcaptions.com/v1`
- URL: `https://api.justcaptions.com/v1/auto-edit`
- Auth: HTTP bearer

Text-character metering; no audio/video upload or server-side video rendering. Delegated keys denied. Uses existing planner/providers. Default independent_shorts=true; fewer clips may be returned when material is insufficient.

## Request body

- object
  - `duration_seconds` number, required
  - `transcript` object[], required
    - `start` number, required
    - `end` number, required
    - `text` string, required
  - `mode` 'talking_head' | 'podcast'
  - `options` object
  - `clip_policy` object
    - `min_clip_count` integer
    - `max_clip_count` integer
    - `target_min_duration` number
    - `target_max_duration` number
    - `independent_shorts` boolean
  - `sentence_ranges` object[]: Optional sorted nonoverlapping complete-sentence spans inside the supplied transcript and video. Invalid supplied ranges rejected. Omit for punctuation-derived boundaries or explicitly diagnosed word fallback.
    - `start` number, required
    - `end` number, required

## Response `200`

Validated source timeline clips, safe aggregate diagnostics and usage.text_chars; planner output only

## Other responses

- `400`: invalid_request
- `401`: invalid_api_key
- `403`: scope_denied (delegated keys)
- `429`: quota or spend cap exceeded
- `503`: provider or backend unavailable

---

[API](https://skmtc.dev/justcaptions/apis/just-captions-api.md) · [All operations](https://skmtc.dev/justcaptions/apis/just-captions-api/llms.txt) · [OpenAPI document](https://skmtc.dev/justcaptions/apis/just-captions-api/revisions/bbd6b38c1cef?raw)