Skip to main content
POST
Create a reusable, persisted character image

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
prompt
string
required

Text description of the character to generate.

Minimum string length: 1
referenceImageUrl
string<uri>

Optional public HTTPS URL of a reference image to guide identity. http:// URLs are rejected.

Response

The request has succeeded.

id
string
required

Persisted character id (char_...). Reuse it later via cloneStartingImage's characterId or GET /v1/characters/{id}.

imageUrl
string<uri>
required

HTTPS CDN URL of the generated character image.

model
string
required

Provider model id that produced the image.