GET

/v1/schemas/kling/image/v1/images/generations

Accept:

kind inputactivity imagehash 83beb344…extracted Aug 15, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. docs-derived Source trace `909c71aea16848604ee3f0eea849aa72404db67ff4814a654942f4f6f085ed30` { "fetchedAt": 1786771298, "extractorVersion": "1", "verifiedAt": null }

Request body

12 properties · 1 required · 0 $defs

property	type	description	constraints
prompt*	string		length ≤ 2500
model_name	string	Image model id. Documented values include kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1, kling-image-o1. Default kling-v1.
negative_prompt	string	Not supported in image-to-image mode.	length ≤ 2500
image	string	Reference image (raw base64 or https URL).
image_reference	enum	Required on kling-v1-5 when `image` is set.	subject \| face
image_fidelity	number		0 ≤ n ≤ 1
human_fidelity	number	Face similarity when image_reference=subject. Default 0.45.	0 ≤ n ≤ 1
resolution	enum		1k \| 2k
n	integer	Number of images. Each occupies one concurrency slot.	1 ≤ n ≤ 9
aspect_ratio	enum		16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 3:2 · +2 more
callback_url	string		format: uri
external_task_id	string

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"kling","endpointId":"v1/images/generations","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}