Create a static image

Render one PNG, JPEG, or WebP from raw HTML, an inline stateless template, or one owned saved-template version. Returns 200 for a terminal job or 202 while the accepted job remains queued or running. A terminal job can be succeeded, failed, or cancelled; check status before downloading, then use file downloads to read the finished file. Send wait=false to skip the bounded wait. A successful render costs exactly one credit; a failed or cancelled render costs zero.

post/v1/image

Request

  • Base URL: https://thirds.ai
  • URL: https://thirds.ai/v1/image
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Request body

OR
OR

Response

The job is terminal. Check status for succeeded, failed, or cancelled; HTTP 200 does not mean the render succeeded.

referencestring

Your reference, preserved in the job, history, and webhook. Omitted when not supplied.

idstring required
status'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled' required
created_atstring date-time required
finished_atstring date-time nullable required
credit'reserved' | 'settled' | 'released' | 'free' | 'none' required

What happened to the credit this job holds: "reserved" while it is queued or running, "settled" once it succeeded, "released" once it failed or was cancelled, "free" when it is the account's free first file and costs no credit, and "none" when the job was never billed.

Changes

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