Estimate a Sume timeline render before paying: the unbilled plan call

POST /v1/timeline-1.0/plan runs the same schema checks, Sume-host URL checks and compiler as a render, then returns the plan without creating a job or reserving credits. Use it to read billable_minutes and estimated_cost_usd_micros before you submit a long or multi-language render.

What the plan returns

The response has object: timeline_plan with the fields below. An Idempotency-Key is not required because nothing is created.

Limits of a plan

A plan does not download media, so it cannot predict short-source pad or loop warnings. Those appear as soft warnings[] on the finished render, not as failures.

Use the plan result to fail early when a document is invalid: a missing media.sume.com URL, video[0].start not 0, or audio parts that sum to less than duration_seconds.

When it pays off

A 30-minute render is the cap (audio.duration_seconds up to 1,800) and bills 30 minutes. Plan each language version first, check the minutes match the spine you expect, then render. The check costs nothing and avoids a paid job with the wrong length.