Create Run

Create one queued run and return {run_id, status, eta_sec, options_effective}.

options_effective.resolved_order is the authoritative per-format count and request-compiler activation echo for the accepted run.

THIS CALL SPENDS QUOTA when a new run is accepted. Call GET /v1/account first, send one Idempotency-Key per intended run, then poll GET /v1/runs/{run_id}/progress first at eta_sec and at most once every 60 to 120 seconds. Recover from quota_exceeded through POST /v1/billing/checkout; for concurrency_limited or daily_limit, wait retry_after_sec before retrying. Fix validation_error, source_invalid, or feature_not_entitled before a new attempt.

post/runs

Request

Base URL: https://www.clipzyn.com/v1
URL: https://www.clipzyn.com/v1/runs
Auth: HTTP bearer

Request body

storage_pathstring nullable

source_urlstring nullable

top_ninteger

sub_clipsboolean

shortsboolean

midformboolean

midform_ninteger nullable

midform_requeststring nullable

trailerboolean

trailer_requeststring nullable

twitterboolean

twitter_ninteger nullable

twitter_requeststring nullable

carouselsboolean

carousels_ninteger nullable

carousels_requeststring nullable

clip_requeststring nullable

count_mode'exact' | 'engine' nullable

engine'standard' | 'deep' nullable

The cut to run: 'standard' (the normal cut) or 'deep' (the deep cut). Omit it for the default routing. 'deep' is refused with validation_error while the deep cut is switched off. Echoed as options_effective.engine.

titlestring nullable

host_namestring nullable

guest_namestring nullable

source_typestring

duration_secnumber nullable

pulse_recorded_atstring nullable

pulse_go_live_atstring nullable

pulse_episode_contextstring nullable

pulse_focus_topicsstring[] nullable

pulse_avoid_topicsstring[] nullable

pulse_source_published_atstring nullable

Response

Successful Response

run_idstring required

statusstring required

eta_secinteger nullable

options_effectiveOptionsEffective required

deprecation_noticestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.