TokenLab, Video API İş Akışları için Kling 3.0 Element Referansları Ekledi

Bir ayakkabı ve bir el içeren ürün demosu, tek bir görsel çapa değil, iki görsel çapaya ihtiyaç duyar. Artık video oluşturma API'sinde Kling 3.0 element referanslarını destekliyoruz. Kling 3.0 element referansları API'si, geliştiricilerin belirli ürünleri, aksesuarları veya karakterleri, oluşturulan klip boyunca tutarlı kalan adlandırılmış etiketlere (@name) sabitlemelerine olanak tanır. Bu, tek bir referans görselinin birden fazla özneyi kareler arasında görsel olarak sabit tutmak için yeterli olmadığı görüntü tabanlı video iş akışlarındaki bir boşluğu doldurur.

Çok Özneli Videolar Neden Element Referanslarına İhtiyaç Duyar?

Tek bir referans görseli, tek bir özne için işe yarar. Ancak bir sahnede birden fazla farklı öğenin kalıcı olması gerektiğinde yetersiz kalır. Örneğin, bir el tarafından tutulan bir ürün, hem ürünün hem de elin sabit kalmasını gerektirir. Diyalog halindeki iki karakter, ayrı yüz ve kıyafet sürekliliğine ihtiyaç duyar. Bu boşluğu gidermek için artık Kling 3.0 element referanslarını destekliyoruz.

Önemli Çıkarımlar

• Kling 3.0 element referansları, referans görsel URL'leri ile adlandırılmış elementler tanımlamanıza ve ardından bunları doğrudan prompt metninizde etiketle (@productA, @character1) çağırmanıza olanak tanır.
• Bu özellik çok özneli sahneler için tasarlanmıştır: ürün artı el modeli, karakter artı aksesuar, diyalog çekimindeki iki karakter ve istek başına bir referans görselinin daha önce sınırlayıcı olduğu benzer kurulumlar.
• kling_elements ile output_audio=true parametrelerini aynı istekte birleştirmeyin. Mevcut API sözleşmesi gereği bu iki parametre birbirini dışlar.
• Element referansları, TokenLab'in diğer modeller için mevcut olan referanstan videoya desteğinin yanında yer alır. Geliştiricilere her kullanım durumu için doğru yaklaşımı seçme konusunda tutarlı bir model sunarlar.

Kling 3.0 Element Referansları API'si Nasıl Çalışır?

Çoğu görüntü tabanlı video oluşturma süreci, bir referans görselini tek bir çapa olarak ele alır. Modele bir resim verirsiniz ve o, etrafındaki hareketi canlandırırken genel görünümü tutarlı tutmaya çalışır. Bu, tek özneli çekimler için işe yarar. Ancak bir sahnede görsel olarak birbirinden bağımsız birden fazla öğenin kalıcı olması gerektiğinde bu yöntem hızla başarısız olur.

Kling 3.0'ın element referansları, tek bir istekte birden fazla adlandırılmış referans görseli kaydetmenize izin vererek bu sorunu çözer. Ardından, prompt metninin içinden bu öğelere ayrı ayrı işaret edersiniz. Tek bir örtük referans yerine, açık ve adreslenebilir referanslara sahip olursunuz. Model, @shoe ifadesinin bir numaralı referans görseline, @model ifadesinin ise iki numaralı referans görseline karşılık geldiğini bilir. Sahneyi her iki çapayı da aynı anda kullanarak oluşturur.

Bu modeli mevcut API sözleşmesinde gördük. Bu, ürün videosu hatları, karakter odaklı içerik araçları ve reklam yaratıcıları için kontrolde anlamlı bir adımdır. Bir klip boyunca özne tutarlılığı, genellikle kullanılabilir bir çıktı ile yeniden çekim yapma arasındaki farktır.

İsteklerde Kling 3.0 Element Referansları API'sini Kullanma

Model oldukça basittir: elementlerinizi tanımlayın, adlandırın ve prompt içinde @ sözdizimi ile bunlara referans verin.

{
  "model": "kling-3.0",
  "prompt": "@shoe mermer bir kaide üzerinde yavaşça dönerken @hand onu almak için uzanıyor",
  "kling_elements": [
    {
      "name": "shoe",
      "image_url": "https://example.com/product-shoe.png"
    },
    {
      "name": "hand",
      "image_url": "https://example.com/hand-reference.png"
    }
  ],
  "duration": 5,
  "aspect_ratio": "16:9"
}

Uygulama için birkaç pratik not:

• Element adları kısa ve net olmalıdır. Prompt metninizde zaten görünmesi muhtemel yaygın İngilizce kelimelerle çakışan isimlerden kaçının. Bu çakışma, ayrıştırma belirsizliği olasılığını artırır.
• Referans görsel URL'lerinin istek anında herkese açık olarak erişilebilir olması gerekir. Görselleriniz kimlik doğrulamalı bir depolama katmanının arkasındaysa, isteği göndermeden önce imzalı veya herkese açık bir URL oluşturun.
• Bir prompt içinde birden fazla elementi birleştirebilirsiniz, ancak toplam sahne açıklamasını odaklanmış tutun. İkiden veya üçten fazla adlandırılmış elementi üst üste yığmak, modelin her birini ayrı ayrı takip etme yeteneğini zayıflatma eğilimindedir. Bu, statik bir görüntü promptunda çok fazla adlandırılmış özne olmasının özne başına sadakati azaltmasına benzer.
• Önce kısa bir süre ile test edin. Element tutarlılığı sorunları, eğer oluşacaksa, ilk birkaç saniyede ortaya çıkar. Bunları 3 saniyelik bir taslakta yakalamak, 10 saniyelik tam bir render'a göre daha kolaydır.

Uygulama Kontrol Listesi

Bir Kling 3.0 element referansı iş akışını üretime almadan önce şunları onaylayın:

• Her elementin benzersiz ve net bir adı var
• Referans görsel URL'leri herkese açık olarak erişilebilir ve işleme süresi boyunca kararlı
• Prompt metni, her elementi @name sözdizimi ile doğru şekilde etiketliyor
• kling_elements mevcut olduğunda output_audio değeri true olarak ayarlanmamış
• İstek doğrulaması, ses artı element çakışmasını API'ye ulaşmadan önce yakalıyor
• Test render'ları, tam uzunlukta oluşturmaya geçmeden önce kısa süreler kullanıyor
• İstek başına toplam adlandırılmış element sayısı en iyi tutarlılık için iki veya üçte kalıyor

Tek Kural: Elementler Artı Ses Yok

Bu kısıtlamayı hızlı prototipleme sırasında gözden kaçırmak kolaydır: kling_elements ve output_audio=true aynı istekte kullanılamaz. Her ikisini de gönderirseniz, istek beklendiği gibi işlenmeyecektir.

İş akışınız hem çok elementli görsel tutarlılık hem de oluşturulmuş ses gerektiriyorsa, çalışmayı iki adıma bölün. Önce videoyu element referanslarıyla oluşturun. Ardından ses oluşturma işlemini ayrı olarak çalıştırın ve çıktıları daha sonra birleştirin. Bu, bir hata değil, mevcut Kling 3.0 entegrasyonunun belgelenmiş bir kısıtlamasıdır. İstek doğrulama mantığınızı, bunu sonradan yakalanacak bir uç durum olarak ele almak yerine bu kısıtlamaya göre oluşturun.

Kendi hattımızda, isteği göndermeden önce bu çakışmayı istemci tarafında doğruluyoruz.

Kling 3.0 Element Referansları API'si vs. Diğer Video İş Akışları

Element referansları, TokenLab'in video API'si aracılığıyla sunulan, giderek büyüyen referanstan videoya yetenekleri setindeki bir araçtır. Hangisine ne zaman başvuracağınızı bilmek yardımcı olur:

İş Akışı	En İyi Olduğu Alan	Referans Sayısı	Notlar
Tek görüntüden videoya	Tek bir statik görüntünün basit animasyonu	1	Seedance ve PixVerse V6 dahil çoğu desteklenen video modelinde çalışır
Kling 3.0 element referansları	Bağımsız tutarlılık gerektiren çok özneli sahneler	2-3 adlandırılmış element	Aynı istekte ses yok
Stil veya hareket referansı	Görsel bir stil veya kamera hareketi deseni uygulama	1 stil referansı + prompt	Seçili modellerde mevcuttur, model bazlı belgelere bakın
Sadece metinle promptlama	Hızlı yineleme, görsel çapa gerekmez	0	Prototiplemesi en hızlı, kontrol edilebilirliği en düşük

Bir ürün demosu oluşturucu geliştiriyorsanız, element referansları genellikle doğru tercihtir. Tek bir ana görselin basit animasyonunu yapıyorsanız, düz görüntüden videoya yöntemi daha hızlıdır ve üzerinde yineleme yapmak daha ucuzdur. Video modellerini daha geniş bir şekilde karşılaştıran ekipler, 2026'da API kullanımı için en iyi AI video modelleri dökümü ile başlayabilir. Bu döküm, Kling 3.0'ın farklı kullanım durumları için Veo 3 ve diğer seçeneklere karşı nasıl bir performans sergilediğini kapsar.

SSS

Tek bir Kling 3.0 isteğinde ikiden fazla element referansı kullanabilir miyim?

Evet, API sayıya katı bir sınır koymaz, ancak tek bir sahneye daha fazla adlandırılmış element ekledikçe pratik tutarlılık düşme eğilimindedir. İki ila üç, çoğu ürün ve karakter kullanım durumu için makul bir çalışma sınırıdır.

Hem kling_elements hem de output_audio=true gönderirsem ne olur?

Bu iki parametre mevcut Kling 3.0 entegrasyonunda birbirini dışladığı için istek doğru şekilde işlenmeyecektir. Boşa giden çağrılardan kaçınmak için bu kombinasyonu isteği göndermeden önce istemci tarafında doğrulayın.

Element referansı desteği Kling 3.0'a mı özgü, yoksa diğer modellerde de var mı?

@name etiketlemesi ile adlandırılmış element referansları, mevcut API'de Kling 3.0'a özgüdür. Desteklenen diğer video modellerinin kendi referanstan videoya modelleri vardır. Bunlar genellikle istek başına tek bir referans görseli ile sınırlıdır, bu nedenle özellik eşitliğini varsaymadan önce modele özel belgelere bakın.

Kaynaklar, Güncellik ve İlgili Okumalar

Bu makale, 07.07.2026 tarihinde gözlemlenen TokenLab video API belgelerini ve Kling 3.0 entegrasyon davranışını yansıtmaktadır. Güncel parametre referansı için video oluşturma API referansına ve video oluşturma kılavuzuna bakın. API davranışı değişebilir, bu nedenle bir üretim entegrasyonunu tamamlamadan önce her zaman canlı belgeleri kontrol edin.

Element referansları, Kling 3.0 ile mümkün olanları genişletir, ancak doğru video modelini seçmek ve maliyetleri anlamak, bir üretim iş akışı oluşturmadan önce hala önemlidir. Seçenekleri karşılaştırıyorsanız, En İyi AI Video Modelleri API Kılavuzu: Geliştiriciler Video Oluşturma Modellerini Nasıl Seçmeli başlıklı yazı, sağlayıcılar arasındaki ödünleşimleri ele alır. Kling'e özel daha yakından bir bakış için, Kling AI API Fiyatlandırma Kılavuzu: Maliyet, İş Akışı ve Alternatifler fiyatlandırma ve iş akışı hususlarını parçalara ayırır. Alternatifleri değerlendiriyorsanız, Seedance API Kılavuzu: AI Video Oluşturma İçin Ne Zaman Kullanılmalı başlıklı yazı, o modelin ne zaman daha uygun olduğunu kapsar.

Model yetenekleri ve fiyatlandırma sık sık değişir, bu nedenle yüksek hacimli üretim kullanımı için güvenmeden önce güncel model sürümlerini ve oranlarını doğrudan doğrulayın. Hesap kurulumu referansı, API anahtarı oluşturmayı açıklar.

Çok özneli video iş akışları oluşturmaya başlamak için TokenLab API anahtarınızı alın ve video oluşturma kılavuzuna göz atın.