Kling Kolors text-to-image (executor coded; awaiting a Kling image resource pack).
Authenticate with the X-API-Key request header.
List price. Volume / bulk customers get a discounted rate — contact us for account pricing.
| Name | Type | Required | Description | Default / options |
|---|---|---|---|---|
| prompt | string | required | Text prompt (max 2500 chars). | — |
| negative_prompt | string | optional | Things to avoid in the output. | — |
| image | string | optional | Optional reference image. | — |
| image_reference | string | optional | How to use the reference image. | facesubject |
| image_fidelity | number | optional | How strongly the result follows the reference image, 0-1. | — |
| human_fidelity | number | optional | Subject/face reference strength, 0-1 (with image_reference). | — |
| n | number | optional | Number of images (1-9). | default: 1 |
| aspect_ratio | string | optional | Output aspect ratio. | default: 16:9 |
| resolution | string | optional | Output resolution. | default: 1k1k2k |
Submitting a job returns 202 Accepted with a job id. Poll GET /v1/jobs/{id} until the job reaches a terminal state, or register a webhook to be notified.
{
"job_id": "job_klingimage_a1b2c3",
"status": "queued"
}{
"id": "job_klingimage_a1b2c3",
"model": "kling-image",
"status": "succeeded",
"output": {
"outputs": [
{
"url": "https://cdn.trinetra.ai/out/kling-image/a1b2c3.png",
"type": "image"
}
]
},
"credits_charged": 10
}Webhook: set a webhook_url on your API key to receive a POST with the terminal job document instead of polling.