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

Topic or video description. Requires at least 1 of prompt or a support image. Prompts longer than 750 characters may be automatically shortened before generation; the response reports this via prompt_compacted

Required string length: 1 - 3000
support_image_url
string

Thumbnail or support image, HTTPS URL. Also accepts YouTube video URLs. If both support_image_url and support_image_base64 are provided, support_image_url is used.

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

Thumbnail or support image, 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,

Response

Success

outputs
string[]
required

Array of 3 title suggestions

prompt_compacted
boolean
required

True when the prompt was shortened automatically before generation

reasoning
string
required

Brief explanation of the generated title strategy

request_id
string
required