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

TokenLab artık video oluşturma API'sinde Kling 3.0 öğe referanslarını destekliyor; bu sayede geliştiriciler, belirli ürünleri, aksesuarları veya karakterleri oluşturulan klip boyunca tutarlı kalan adlandırılmış etiketlere (@name) sabitleyebiliyor. Bu özellik, tek bir referans görüntüsünün birden fazla özneyi kareler boyunca görsel olarak sabit tutmaya yetmediği, görüntü tabanlı video iş akışlarındaki yaygın bir eksikliği gideriyor.

Öne Çıkanlar

• Kling 3.0 öğe referansları, referans görüntü URL'leri ile adlandırılmış öğeler tanımlamanıza ve ardından bunları doğrudan prompt metniniz içinde etiketle (@productA, @character1) çağırmanıza olanak tanır.
• Bu özellik, çok özneli sahneleri hedefler: ürün artı el modeli, karakter artı aksesuar, diyalog çekiminde iki karakter ve daha önce istek başına bir referans görüntüsünün sınırlayıcı olduğu benzer kurulumlar.
• kling_elements ile output_audio=true parametrelerini aynı istekte birleştirmeyin. Mevcut API sözleşmesine göre bu iki parametre birbirini dışlar.
• Öğe referansları, TokenLab'in diğer modeller için mevcut olan referanstan videoya (reference-to-video) desteğinin yanında yer alarak geliştiricilere kullanım durumuna göre doğru yaklaşımı seçmeleri için tutarlı bir model sunar.

Öğe Referansları Aslında Ne Yapar?

Çoğu görüntü tabanlı video oluşturma süreci, bir referans görüntüsünü tek bir çapa olarak ele alır: modele bir resim verirsiniz ve model, etrafındaki hareketi canlandırırken genel görünümü tutarlı tutmaya çalışır. Bu, tek özneli çekimler için iyi çalışır ancak bir sahnede birbirinden bağımsız olarak var olması gereken birden fazla görsel öğe gerektiğinde (örneğin bir el tarafından tutulan bir ürün veya her birinin kendi yüz ve kıyafet sürekliliğine ihtiyaç duyduğu bir diyalog alışverişindeki iki karakter gibi) hızla yetersiz kalır.

Kling 3.0'ın öğe referansları, tek bir istekte birden fazla adlandırılmış referans görüntüsü kaydetmenize ve ardından bunları prompt metninin içinden tek tek işaret etmenize olanak tanıyarak bu sorunu çözer. Tek bir örtük referans yerine, açık ve adreslenebilir referanslara sahip olursunuz. Model, @shoe ifadesinin bir numaralı referans görüntüsüne, @model ifadesinin ise iki numaralı referans görüntüsüne karşılık geldiğini bilir ve sahneyi her iki çapayı da aynı anda kullanarak oluşturur.

Bu, ürün videosu hatları, karakter odaklı içerik araçları veya özne tutarlılığının kullanılabilir çıktı ile yeniden çekim arasındaki farkı belirlediği reklam kreatifleri oluşturan herkes için kontrolde anlamlı bir adımdır.

API'de Öğe Referansları Nasıl Kullanılır?

Model oldukça basittir: öğelerinizi tanımlayın, adlandırın ve prompt içinde @ sözdizimi ile 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:

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

Asla İhlal Etmemeniz Gereken Kural: Öğe ve Ses Birlikte Kullanılamaz

Bu kısım, hızlı prototipleme sırasında gözden kaçması kolay olduğu için açıkça tekrarlanmaya değerdir: 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 öğeli görsel tutarlılık hem de oluşturulmuş ses gerektiriyorsa, mevcut yaklaşım işi iki adıma bölmektir: önce öğe referanslarıyla videoyu oluşturun, ardından ses oluşturma işlemini ayrı olarak çalıştırın ve çıktıları daha sonra birleştirin. Bu, Kling 3.0 entegrasyonunun bir hatası değil, belgelenmiş bir kısıtlamasıdır; bu nedenle istek doğrulama mantığınızı, sonradan yakalanacak bir uç durum olarak değil, bu kısıtlamaya göre oluşturun.

Öğe Referansları vs. Daha Geniş Referanstan Videoya İş Akışları

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

İş Akışı	En İyisi	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 öğe referansları	Bağımsız tutarlılık gerektiren çok özneli sahneler	2-3 adlandırılmış öğe	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 prompt	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, öğe referansları genellikle doğru tercihtir. Tek bir ana görselin basit animasyonunu yapıyorsanız, düz görüntüden videoya (image-to-video) yöntemiyle yineleme yapmak daha hızlı ve daha ucuzdur. Kling 3.0'ın Veo 3 ve diğer seçeneklere karşı farklı kullanım durumlarında nasıl bir performans sergilediği dahil olmak üzere video modellerini daha geniş kapsamlı karşılaştıran ekipler için, 2026'da API kullanımı için en iyi AI video modelleri dökümü iyi bir başlangıç noktasıdır.

Uygulama Kontrol Listesi

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

• Her öğenin benzersiz, net bir adı var
• Referans görüntüsü URL'leri herkese açık olarak erişilebilir ve işleme süresi boyunca kararlı
• Prompt metni, her öğeyi @name sözdizimi ile doğru şekilde etiketliyor
• kling_elements mevcutken output_audio değeri true olarak ayarlanmamış
• İstek doğrulama, ses ve öğe ç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ış öğe sayısı, en iyi tutarlılık için ikide veya üçte kalıyor

SSS

Tek bir Kling 3.0 isteğinde ikiden fazla öğe referansı kullanabilir miyim? Evet, API sayıya kesin bir sınır koymaz, ancak tek bir sahneye daha fazla adlandırılmış öğe 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.

Öğe referansı desteği Kling 3.0'a mı özgü, yoksa diğer modellerde de mevcut mu? @name etiketleme ile adlandırılmış öğe referansları, mevcut API'de Kling 3.0'a özgüdür. Desteklenen diğer video modellerinin kendi referanstan videoya (reference-to-video) modelleri vardır ve bunlar genellikle istek başına tek bir referans görüntüsü ile sınırlıdır, bu nedenle özellik eşitliğini varsaymadan önce modele özel belgelere bakın.

Kaynaklar ve Güncellik

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.

---

Kling 3.0 öğe referanslarını video hattınıza eklemeye hazır mısınız? TokenLab API anahtarınızı alın ve çok özneli video iş akışlarını bugün oluşturmaya başlamak için video oluşturma kılavuzuna göz atın.

İlgili Okumalar ve Sonraki Adım

Öğe referansları Kling 3.0 ile mümkün olanları genişletir, ancak bir üretim iş akışı oluşturmadan önce doğru video modelini seçmek ve maliyetleri anlamak 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 makalesi, sağlayıcılar arasındaki ödünleşimleri ele almaktadır. Kling'e daha yakından bakmak için Kling AI API Fiyatlandırma Kılavuzu: Maliyet, İş Akışı ve Alternatifler, fiyatlandırma ve iş akışı hususlarını detaylandırır. Alternatifleri değerlendiriyorsanız, Seedance API Kılavuzu: AI Video Oluşturma İçin Ne Zaman Kullanılmalı makalesi, bu 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. Öğe referanslarını veya diğer video iş akışlarını test etmeye hazır olduğunuzda, bir API anahtarı oluşturun ve geliştirmeye başlayın.