Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

Your Pikzels API key (prefix: pkz_)

Body

application/json
prompt
string
required

Cannot contain URLs. Prompts longer than 750 characters may be automatically shortened before generation; the response reports this via prompt_compacted

Required string length: 1 - 3000
Pattern: ^(?!.*[Hh][Tt][Tt][Pp]).+$
model
enum<string>
required

Allowed values: "pkz_2", "pkz_3", "pkz_4", "pkz_4_5".

Available options:
pkz_2,
pkz_3,
pkz_4,
pkz_4_5
format
enum<string>
required

Allowed values: "16:9", "9:16", "1:1".

Available options:
16:9,
9:16,
1:1
support_image_url
string

Reference image (pkz_4 and pkz_4_5 only), HTTPS URL. A YouTube watch URL resolves to that video's current thumbnail. If both support_image_url and support_image_base64 are provided, support_image_url is used.

Pattern: ^https://\S+$
support_image_base64
string

Reference image (pkz_4 and pkz_4_5 only), base64 data URL. If both support_image_url and support_image_base64 are provided, support_image_url is used.

Pattern: ^data:image/[a-zA-Z0-9.+-]+;base64,
persona
string

Persona ID. Only personas created through this API can be used, and only on pkz_4 and pkz_4_5

style
string

Style ID. Only styles created through this API can be used, and only on pkz_4 and pkz_4_5

Response

Success

model
string
required

The model that generated this thumbnail

output
string
required

URL to generated thumbnail (expires in 24h)

prompt_compacted
boolean
required

True when the prompt was shortened automatically before generation

request_id
string
required