Skip to main content
POST
/
kling
/
v1
/
images
/
generations
cURL
curl https://api.deerapi.com/kling/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "prompt": "cry",
    "model_name": "kling-v2",
    "image": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-op/effects_raw_pic/magic_fireball-raw.png"
  }'
{
  "code": 123,
  "data": {
    "created_at": 123,
    "task_id": "<string>",
    "task_info": {
      "external_task_id": null
    },
    "task_result": null,
    "task_status": "<string>",
    "task_status_msg": null,
    "updated_at": 123
  },
  "message": "<string>"
}

​
Overview

Use this endpoint to call the Kling Generate workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

​
Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header: 
https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

​
Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

​
Implementation notes

  • Use the OpenAPI playground for the exact request fields accepted by this endpoint.
  • Keep API Keys on the server side when you build production applications.
  • Log the request ID from failed calls so support can investigate the request.
  • Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

​
Authorization
string
header
required

Use a DeerAPI API Key as a Bearer token.

Headers

​
Content-Type
string

Must be application/json.

Body

application/json
​
prompt
string
default:Hello
required

Text prompt describing the image to generate. Maximum 500 characters.

​
negative_prompt
string

Elements to exclude from the image. Maximum 200 characters.

​
image
string

Reference image as a Base64 string (without data: prefix) or public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300×300 px.

​
image_fidelity
number

How closely the output follows the reference image. Range: 0–1.

​
n
integer

Number of images to generate. Range: 1–9.

​
aspect_ratio
string

Output aspect ratio (width:height). Options: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3.

​
callback_url
string

Webhook URL to receive task status updates when the task completes.

​
model_name
string

Kling image model variant to use. See the Models page for current options.

Response

200 - application/json

Successful Response

​
code
integer
required

Error code; specifically define the error code

​
data
object
required
​
message
string
required

error message