Ana içeriğe atla
POST
/
kling
/
v1
/
images
/
generations
Multi-Image to Image
curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject_image_list": [
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
Kling’in birden fazla konu referansına ek olarak isteğe bağlı sahne veya stil referanslarından tek bir görsel üretmesini istediğinizde bu endpoint’i kullanın.

Çağırmadan önce

  • subject_image_list içinde 2 ila 4 görsel sağlayın
  • model_name: kling-v2 kullanın
  • scence_image veya style_image değerini yalnızca çekirdek konu kompozisyonu zaten düzgün çalışıyorsa ekleyin
  • Bunu async bir üretim rotası olarak değerlendirin ve döndürülen task id’yi kaydedin

Görev akışı

1

Görsel üretim görevini gönderin

Konu görsel listesini ve prompt’u gönderin, ardından döndürülen task id’yi saklayın.
2

Görevi sorgulayın

Görev terminal bir duruma ulaşana kadar Kling görsel sorgu yolunu kullanarak Individual Queries ile devam edin.
3

Sonucu kalıcı olarak saklayın

Kalıcı erişime ihtiyacınız varsa oluşturulan görseli kendi depolama alanınıza kaydedin.
Tam parametre referansı için resmî Kling dokümantasyonuna bakın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

Content-Type
string

Content type of the request body.

Gövde

application/json

Kling Image Generation API request body definition

subject_image_list
object[]
gerekli

List of subject reference images. Minimum 2, maximum 4.

model_name
enum<string>
varsayılan:kling-v2

Model to use for multi-image generation.

Mevcut seçenekler:
kling-v2
prompt
string

Text prompt describing the desired output. Max 2500 characters.

scence_image
string

Optional scene reference image. Same format and size constraints as subject images.

style_image
string

Optional style reference image. Same format and size constraints as subject images.

n
integer
varsayılan:1

Number of images to generate.

aspect_ratio
enum<string>
varsayılan:16:9

Aspect ratio of the generated image (width:height).

Mevcut seçenekler:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Yanıt

200 - application/json

Successful Response

code
integer

Error code; specifically define the error code

message
string

error message

request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

data
object