Skip to main content
POST
cURL
Kling’in birden fazla konu referansına ek olarak isteğe bağlı sahne veya stil referanslarından tek bir görsel oluşturmasını istediğinizde bu endpoint’i kullanın.

Çağırmadan önce

  • subject_image_list içinde 1 ila 4 görsel sağlayın
  • Yeni istekler için model_name: kling-v2-1 kullanın
  • scene_image veya style_image alanlarını yalnızca temel konu kompozisyonu zaten çalışıyorsa ekleyin
  • Bunu async bir üretim rotası olarak değerlendirin ve dönen görev kimliğini kaydedin

Görev akışı

1

Görsel oluşturma görevini gönderin

Konu görsel listesini ve prompt’u gönderin, ardından dönen görev kimliğini saklayın.
2

Görevi sorgulayın

Görev son duruma ulaşana kadar, dönen görevi eşleşen Kling görsel sorgu yolu ile sorgulayın.
3

Sonucu kalıcı olarak saklayın

Kalıcı erişime ihtiyacınız varsa oluşturulan görseli kendi depolamanı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
varsayılan:application/json

Must be application/json.

Gövde

application/json
subject_image_list
object[]
gerekli

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
varsayılan:kling-v2

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

Mevcut seçenekler:
kling-v2,
kling-v2-1
prompt
string

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_image
string

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

n
integer
varsayılan:1

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

Gerekli aralık: 1 <= x <= 9
aspect_ratio
enum<string>
varsayılan:16:9

Aspect ratio of the generated image.

Mevcut seçenekler:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
watermark_info
object

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Yanıt

200 - application/json

Task request accepted or an error response returned by the API.

code
gerekli

Response code. 0 means the task request was accepted.

message
string
gerekli

Response message.

data
object
gerekli
request_id
string

Request identifier returned when present.