funko
browser-session

Render one orthographic head view (PAID)

Clerk-session only and runId-gated. Spends real generation credits, so it does not run at all without a live runId issued to this caller. Later views are conditioned on the approved front image so the turnaround stays the same person. The photo is a data URI and the body ceiling is 4 MB - base64 is ~1.37x the raw bytes, so the client must downscale before posting.

post/api/funko/view

Request

  • Base URL: https://www.immersivecommons.com
  • URL: https://www.immersivecommons.com/api/funko/view
  • Auth: API key in cookie __session

Request body

runIdstring required

Must be live and owned by the caller.

photostring required

A data: URI. Base64 is ~1.37x the raw bytes and the body ceiling is 4 MB, so downscale first.

view'front' | 'side' | 'back' | 'bottom' required
frontUrlstring

The approved front render. Conditions side/back/bottom so the turnaround stays the same person.

traitsobject

Normalized identity traits, locked into the prompt.

retryDefectsstring[]

Defect ids from a prior inspect pass, to steer the retry.

Response

The upstream task id to poll with GET /api/funko/task.

okboolean required
taskIdstring required

Poll with GET /api/funko/task.

Changes

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