films

Make a film

Starts a film from a plan_id (or straight from a brief) and returns at once. The estimate is held on your balance while the film is made; you pay what it really cost, never more than the estimate or max_cost_cents. A film that fails or is cancelled is not charged. A 50 second 720p film takes about 15 to 30 minutes. Idempotency-Key is honoured.

post/v1/films

Request

Base URL: https://api.corent.tech (the document declares no server; this is the origin it was published from)
URL: https://api.corent.tech/v1/films
Auth: HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

duration_sinteger

Length of the finished film, 10 to 120 seconds.

aspect_ratio'16:9' | '9:16' | '1:1'

Frame shape.

resolution'720p' | '1080p'

Output resolution. 1080p costs about 2.25 times more.

languagestring nullable

Language for the dialogue. Defaults to the brief's language.

customer_idstring nullable

Optional tag for YOUR end user, so you can attribute spend: 1 to 128 characters from A-Z a-z 0-9 . _ : @ -. Stored on the job, returned on receipts, and filterable with GET /v1/account/usage?customer_id=...

plan_idstring nullable

A plan from POST /v1/films/plan. Its script and options are used as they are.

briefstring nullable

Or skip the plan step and pass a brief.

max_cost_centsinteger required

The most you agree to pay. The film is refused if its estimate is higher, and the bill never goes above it.

webhook_urlstring nullable

https URL that receives the finished (or failed, or cancelled) film.

webhook_secretstring nullable

When set, deliveries carry X-Corent-Signature.

Example request

{
  "max_cost_cents": 2500,
  "plan_id": "3f6c1a52-7d0e-4c1f-9f55-0d7d2a8f4b11"
}

Response

Successful Response

film_idstring required

statusstring required

estimated_cost_centsinteger required

Changes

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