Skip to main content
POST
cURL

Görüntü oluşturma

Tam parametre başvurusu için resmi Kling dokümantasyonuna bakın.
Bu endpoint’i, Kling’in görüntü oluşturma API’si aracılığıyla durağan görüntüler oluşturmak için kullanın. Yalnızca metin içeren istekleri ve aynı asenkron görev akışı üzerinden görüntü referanslı istekleri destekler.

İlk istek

model_name: kling-v3, prompt, n ve aspect_ratio ile başlayın. Referans görüntüleri, doğruluk kontrollerini veya gelişmiş alanları yalnızca ilk istek kullanılabilir bir görev döndürdükten sonra ekleyin. model_name alanını atlamak eski bir uyumluluk varsayılanını kullanır; bu nedenle yeni entegrasyonlar için kling-v3 değerini açıkça gönderin.

Yanıtı okuyun

Döndürülen task_id değerini kaydedin, ardından task_status son duruma ulaşana kadar eşleşen Kling görüntü sorgulama yolunu yoklayın. İş akışınız kalıcı depolama gerektiriyorsa, oluşturma tamamlandıktan sonra nihai varlığı kendi depolama katmanınıza kopyalayı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
prompt
string
gerekli

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

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

Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.

Mevcut seçenekler:
kling-v1,
kling-v1-5,
kling-v2,
kling-v2-1,
kling-v3
negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.

image
string

Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

image_reference
enum<string>

Reference mode for legacy image-to-image requests when image is provided.

Mevcut seçenekler:
subject,
face
image_fidelity
number
varsayılan:0.5

How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.

Gerekli aralık: 0 <= x <= 1
human_fidelity
number
varsayılan:0.45

Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.

Gerekli aralık: 0 <= x <= 1
element_list
object[]

Optional Kling element references. The total count of element references and input images must not exceed 10.

resolution
enum<string>
varsayılan:1k

Output resolution. Defaults to 1k.

Mevcut seçenekler:
1k,
2k
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

Output aspect ratio (width:height).

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 to receive task status updates when the task completes.

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.