图像生成

Create image

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "human_fidelity": 123,
  "image": "<string>",
  "image_fidelity": 123,
  "image_reference": "<string>",
  "model_name": "<string>",
  "n": 123,
  "negative_prompt": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/images/generations"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "human_fidelity": 123,
    "image": "<string>",
    "image_fidelity": 123,
    "image_reference": "<string>",
    "model_name": "<string>",
    "n": 123,
    "negative_prompt": "<string>",
    "prompt": "<string>",
    "resolution": "<string>",
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    human_fidelity: 123,
    image: '<string>',
    image_fidelity: 123,
    image_reference: '<string>',
    model_name: '<string>',
    n: 123,
    negative_prompt: '<string>',
    prompt: '<string>',
    resolution: '<string>',
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/images/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'human_fidelity' => 123,
    'image' => '<string>',
    'image_fidelity' => 123,
    'image_reference' => '<string>',
    'model_name' => '<string>',
    'n' => 123,
    'negative_prompt' => '<string>',
    'prompt' => '<string>',
    'resolution' => '<string>',
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/images/generations"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ],
      "result_type": "<string>",
      "series_images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ],
        "result_type": "<string>",
        "series_images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

POST

kling

images

generations

Create image

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "human_fidelity": 123,
  "image": "<string>",
  "image_fidelity": 123,
  "image_reference": "<string>",
  "model_name": "<string>",
  "n": 123,
  "negative_prompt": "<string>",
  "prompt": "<string>",
  "resolution": "<string>",
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/images/generations"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "human_fidelity": 123,
    "image": "<string>",
    "image_fidelity": 123,
    "image_reference": "<string>",
    "model_name": "<string>",
    "n": 123,
    "negative_prompt": "<string>",
    "prompt": "<string>",
    "resolution": "<string>",
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    human_fidelity: 123,
    image: '<string>',
    image_fidelity: 123,
    image_reference: '<string>',
    model_name: '<string>',
    n: 123,
    negative_prompt: '<string>',
    prompt: '<string>',
    resolution: '<string>',
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/images/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/images/generations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'human_fidelity' => 123,
    'image' => '<string>',
    'image_fidelity' => 123,
    'image_reference' => '<string>',
    'model_name' => '<string>',
    'n' => 123,
    'negative_prompt' => '<string>',
    'prompt' => '<string>',
    'resolution' => '<string>',
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/images/generations"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/images/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/images/generations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"human_fidelity\": 123,\n  \"image\": \"<string>\",\n  \"image_fidelity\": 123,\n  \"image_reference\": \"<string>\",\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"negative_prompt\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ],
      "result_type": "<string>",
      "series_images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ],
        "result_type": "<string>",
        "series_images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

路径 POST /kling/v1/images/generations
Image O1 与 Image 3.0 Omni 请使用 Omni 图像，不使用本入口。
字段详解：请参考官网权威文档

请求参数

参数	类型	必填	说明
`model_name`	string	否	模型名称，默认 `kling-v1`。可选：`kling-v1`、`kling-v1-5`、`kling-v2`、`kling-v2-new`、`kling-v2-1`、`kling-v3`
`prompt`	string	是	正向文本提示词
`negative_prompt`	string	否	负向文本提示词（图生图场景不支持）
`image`	string	否	参考图像 URL 或 Base64
`image_reference`	string	否	图片参考类型：`subject`（角色特征）、`face`（人物长相），仅 `kling-v1-5` 支持
`image_fidelity`	number	否	图片参考强度 [0, 1]
`human_fidelity`	number	否	面部参考强度 [0, 1]
`element_list`	array	否	Image 3.0 主体引用 `[{"element_id":...}]`，保留64位ID精度
`resolution`	string	否	清晰度：`1k`（标清）、`2k`（高清），默认 `1k`
`n`	int	否	生成图片数量 [1, 9]，默认 1
`aspect_ratio`	string	否	纵横比：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`3:2`、`2:3`、`21:9`，默认 `16:9`
`watermark_info`	object	否	是否生成含水印结果
`callback_url`	string	否	回调通知地址
`external_task_id`	string	否	自定义任务ID

注意：使用 kling-v1-5 且 image 参数不为空时，image_reference 参数必填。非 kling-v1-5 模型不支持 image_reference。 补充约束：prompt 长度 ≤ 2500；图生图场景（image 非空）不支持 negative_prompt。 模型边界：kling-v3-omni 仅通过 /kling/v1/images/omni-image 放行；kling-v2-5-turbo 等视频模型不能用于 /images/generations。

场景一：文生图

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v1",
    "prompt": "A beautiful sunset over the ocean, vibrant colors, high detail",
    "resolution": "2k",
    "n": 1,
    "aspect_ratio": "16:9"
  }'

场景二：角色特征参考

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v1-5",
    "prompt": "The character holding a magic wand in a fantasy forest",
    "image": "https://example.com/character-reference.jpg",
    "image_reference": "subject",
    "image_fidelity": 0.8,
    "resolution": "2k",
    "aspect_ratio": "3:4"
  }'

场景三：人脸参考

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v1-5",
    "prompt": "A professional headshot portrait, business attire, studio lighting",
    "image": "https://example.com/face-photo.jpg",
    "image_reference": "face",
    "human_fidelity": 0.9,
    "resolution": "2k",
    "aspect_ratio": "1:1"
  }'

场景四：批量生成

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v2",
    "prompt": "Abstract colorful artwork, modern style",
    "n": 4,
    "resolution": "1k",
    "aspect_ratio": "1:1"
  }'

示例响应

{
  "code": 0,
  "message": "success",
  "request_id": "req_1735558800_img123",
  "data": {
    "task_id": "task_01JGHP...",
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}

任务成功响应

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "task_01JGHP...",
    "task_status": "succeed",
    "task_result": {
      "images": [
        {"index": 0, "url": "https://..."},
        {"index": 1, "url": "https://..."}
      ]
    }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

aspect_ratio

string

纵横比

callback_url

string

回调通知地址

element_list

object[]

Show child attributes

external_task_id

string

自定义任务ID

human_fidelity

number

面部参考强度 [0,1]

image

string

参考图像，Base64或URL

image_fidelity

number

图片参考强度 [0,1]

image_reference

string

图片参考类型：subject, face

model_name

string

模型名称，默认kling-v1

integer

生成图片数量 [1,9]

negative_prompt

string

负向文本提示词

prompt

string

正向文本提示词，必须

resolution

string

清晰度：1k, 2k

watermark_info

object

水印信息

Show child attributes

Response

200 - application/json

code

integer

错误码

data

object

单个任务数据

Show child attributes

data_list

object[]

任务列表数据

Show child attributes

message

string

错误信息

request_id

string

请求ID

概述

API 2.0

Legacy 视频生成

视频编辑

任务管理

图像生成

场景一：文生图

场景二：角色特征参考

场景三：人脸参考

场景四：批量生成

Authorizations

Body

Response

​场景一：文生图

​场景二：角色特征参考

​场景三：人脸参考

​场景四：批量生成

Authorizations

Body

Response

场景一：文生图

场景二：角色特征参考

场景三：人脸参考

场景四：批量生成