Skip to main content
POST
cURL
CometAPI üzerinden eşzamansız bir Kling Omni Image görevi oluşturmak için bu endpoint’i kullanın. Oluşturma isteği bir task_id döndürür; oluşturulan görüntü URL’leri kullanılabilir olana kadar görevi sorgulamak için Kling Omni görüntü görevini alma öğesini kullanın.
Eksiksiz sağlayıcı parametresi başvurusu için şu belgeye bakın: Kling Image O1 dokümantasyonu.

İstek biçimini seçin

  • Tek görüntü oluşturma: prompt, image_list, resolution, result_type: single, n ve aspect_ratio gönderin
  • Filigranlı çıktı: sorgu yanıtında filigranlı sonuç URL’sine ihtiyacınız olduğunda watermark_info.enabled: true ekleyin
  • Model ID: rota varsayılanını kullanmak için model_name değerini atlayın veya kling-image-o1 ya da kling-v3-omni gibi test edilmiş bir Omni Image model ID gönderin
Referans görüntüler, image_list alanına sahip image öğelerini kullanır. Prompt, ilk öğe için <<<image_1>>> ve ikinci öğe için <<<image_2>>> gibi ifadelerle bunlara dizine göre başvurabilir.

Görev akışı

1

Görevi oluşturun

POST /kling/v1/images/omni-image gönderin ve döndürülen data.task_id değerini saklayın.
2

Görevi sorgulayın

Şu GET /kling/v1/images/omni-image/ işlemini data.task_status değeri succeed veya failed olana kadar sorgulayın.
3

Görüntüleri kalıcı olarak saklayın

Görev başarılı olduğunda, kalıcı erişime ihtiyacınız varsa data.task_result.images[].url değerini kendi depolama alanınıza kopyalayın.
Tam yanıt şeması ve görev durumu ayrıntıları için şu belgeye bakın: Kling Omni görüntü görevini alma. Aşağıdaki istek bir görevi bir kez sorgular:

Sonuç alanları

Başarılı sorgu yanıtları, oluşturulan görüntüleri data.task_result.images altında döndürür. Her öğe şunları içerebilir: Oluşturulan varlık URL’lerinin süresi dolabilir veya sağlayıcı hizmet tarafından kaldırılabilir. İş akışınız uzun süreli saklama gerektiriyorsa tamamlanan görüntüleri kendi depolama katmanınızda saklayın.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI API key.

Başlıklar

Content-Type
string

Must be application/json.

Gövde

application/json
prompt
string
gerekli

Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.

model_name
string

Optional model ID for this Omni Image request. Omit this field to use the route default.

image_list
object[]

Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.

resolution
enum<string>
varsayılan:1k

Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.

Mevcut seçenekler:
1k,
2k,
4k
result_type
enum<string>
varsayılan:single

Use single for a single-image task.

Mevcut seçenekler:
single
n
integer
varsayılan:1

Number of single-image results to generate. Range: 1 to 9.

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

Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.

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

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.

callback_url
string<uri>

Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.

external_task_id
string

User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.

Yanıt

200 - application/json

Task accepted.

code
integer
gerekli

Response code. 0 means the task request was accepted.

message
string
gerekli

Response message.

data
object
gerekli
request_id
string

Request identifier returned by CometAPI when present.

Son değiştirilme tarihi 31 Temmuz 2026