Generations

Start a draft

Start a draft created with mode: "draft", using its latest settings from the Martini canvas.

post/v1/generations/{id}/generate

Request

  • Base URL: https://api.martini.film
  • URL: https://api.martini.film/v1/generations/{id}/generate
  • Auth: HTTP bearer

Path parameters

idstring required

The draft generation id.

Response

The generation, now pending.

idstring required

Public request id; also the canvas asset the generation lands on.

endpointstring required

The registered alias the request was submitted against.

status'draft' | 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' required
origin'api' required
createdAtstring required
startedAtstring nullable required
completedAtstring nullable required
oliveCostnumber nullable required

Snapshotted charge in olives; null only while a concurrent idempotent submit is still being priced.

outputobject nullable required

The model output in its fal field names once status is completed; otherwise null.

warningsstring[] required

Changes

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