Skip to main content
POST
Paint a show_image picture

Authorizations

Authorization
string
header
required

The scoped runtime session JWT from POST /v1/sessions/token. The embed's browser presents it (Authorization: Bearer, or a token body field) to the runtime exchange routes. Not an API key.

Path Parameters

id
string<uuid>
required

Body

application/json
token
string
prompt
string

What to paint. Omit to get the base image.

Response

An image (data-URI when generated, the base image URL otherwise).

src
string

data:… URI or an image URL.

generated
boolean
detail
string

Present on a graceful fallback (quota hit or generation failed), src is the base image and generated is false.

mock
boolean

Present and true only for TEST-mode session tokens. See Testing.