Shotstack Template Create

template-createCandidate

Shotstack Template Create — save a reusable video template from `timeline` + `output` JSON. Templates can be rendered repeatedly with different merge field values via shotstack/template-render. Billed per request.

Open in console

Retail priceinput $0 · per request $0.004

Providershotstack

Capabilityvideo

InterfacePOST /v1/run

Request example

Every paid call needs a unique Idempotency-Key. The same key and payload replay the original result without a second charge.

curl https://router.tycoon.cool/v1/run \
+  -H "Authorization: Bearer $TYCOONROUTER_API_KEY" \
+  -H "Content-Type: application/json" \
+  -H "Idempotency-Key: $(uuidgen)" \
+  -d '{"model":"template-create","inputs":{"messages":[{"role":"user","content":"Hello"}]}}'

Response contract

Synchronous routes return the provider result with TycoonRouter request metadata. Async routes return a request ID plus status and cancel URLs.

Header	Purpose
x-request-id	Immutable Router request identity
x-idempotent-replay	True when the response is a replay
x-tycoonrouter-charge-micros	Settled retail charge when available

Production safeguards

Unknown prices, unbounded requests and uncertain provider outcomes fail closed before a second paid dispatch. Usage and wallet events remain queryable from the account page.