Doğrudan Kling onboarding süreci olmadan Kling API'si nasıl kullanılır: 2026 rehberi

TL;DR Ayrı bir Kling geliştirici onboarding sürecini tamamlamak yerine, CometAPI hesabı ve API anahtarıyla CometAPI üzerinden desteklenen Kling video modellerine erişebilirsiniz. Geçerli metinden videoya rota POST /kling/v1/videos/text2video şeklindedir. Bu istek bir görev kimliği döndürür ve arka ucunuz görev succeed veya failed durumuna ulaşana kadar yoklama yapar. Model kullanılabilirliği, parametreler, fiyatlandırma ve hesap uygunluğu değişebilir; bu nedenle üretim dağıtımından önce canlı model kataloğunu ve API dokümantasyonunu doğrulayın.

Doğrudan yanıt

Pratik yol CometAPI’nin Kling model kataloğudur. İhtiyacınız olan Kling modeli CometAPI hesabınız için kullanılabiliyorsa, sunucunuz CometAPI API anahtarıyla kimlik doğrulayıp ilgili Kling uyumlu uç noktayı çağırabilir. Bu yolda, ayrı bir Kling API başvurusu entegrasyon adımlarının parçası değildir.

Bu ayrım, başka modeller için zaten CometAPI kullanan ekipler açısından önemlidir. Uygulama, bir Kling video iş akışı eklerken tek bir kimlik bilgisi yönetimi yüzeyini ve tek bir sağlayıcı ilişkisini korur. Kodunuz yine de Kling’in videoya özgü istek şemasını ve asenkron görev yaşam döngüsünü kullanmalıdır; “tek API anahtarı” tüm sağlayıcıların aynı istek gövdesini paylaştığı anlamına gelmez.

Bu makale en küçük faydalı entegrasyon olduğu için metinden videoya odaklanır. CometAPI, görüntüden videoya ve diğer Kling iş akışlarını da belgeliyor, ancak her birinin kendi uç noktası ve parametre kısıtları vardır. Canlı dokümantasyonu kontrol ettikten sonra tek bir doğrulanmış yolla başlayın, ardından gerektikçe yetenek ekleyin.

Bu yolun bir geliştirme ekibi için neden yararlı olabileceği

Anında fayda operasyoneldir, sihirli değildir. Zaten CometAPI kullanan bir ekip, başka bir doğrudan sağlayıcı entegrasyonu oluşturmadan, başka bir kimlik bilgisi dağıtmadan veya ayrı bir hesap yönetim yolu inşa etmeden kullanılabilir bir Kling iş akışını ekleyebilir. Bu, platformunuzun sürdürmek zorunda olduğu gizli anahtarların, faturalandırma ilişkilerinin ve sağlayıcıya özel istemci yapılandırmalarının sayısını azaltabilir.

İkinci fayda mimariseldir. Uygulamanız küçük bir dahili video oluşturma sözleşmesi—komut, iş akışı, model, seçenekler ve iş durumu—tanımlayabilirken, bir sağlayıcı adaptörü bu sözleşmeyi belgelenmiş Kling isteğine çevirir. Ekip daha sonra başka bir video modelini değerlendirirse, uç nokta yolları, parametreler ve çıktı metaverileri farklı olsa bile, ürün yüzlü iş modeli sabit kalabilir.

Sınırlama da aynı derecede önemlidir: Birleştirilmiş erişim katmanı, temel modelleri birbirinin yerine kullanılabilir hale getirmez. Komut davranışı, kabul edilen medya, gecikme, fiyatlandırma, güvenlik politikaları ve sonuç şemaları değişebilir. Bu farklılıkları desteklenmeyen varsayımların arkasına gizlemek yerine yapılandırma ve testlerde görünür tutun.

Bu erişim yolunun değiştirdikleri—ve değiştirmedikleri

Değişenler. Bir CometAPI anahtarı oluşturur ve yönetir, istekleri CometAPI’nin Kling uyumlu API’sine gönderir ve kullanımı CometAPI tarafında takip edersiniz. Bu, bu özel erişim yolu için ayrı bir doğrudan Kling onboarding adımını kaldırır.

Değişmeyenler. Kling altta yatan model ailesi olmaya devam eder. Sağlayıcıya özgü parametreler, üretim davranışı, kabul edilebilir kullanım kuralları, model kullanılabilirliği ve çıktı özellikleri hâlâ önemlidir. CometAPI dokümantasyonu ayrıca sağlayıcı istek ve yanıt alanlarının farklı olabileceğini belirtir; bu nedenle uygulamanızın sözleşmesi olarak canlı uç nokta referansını baz alın.

Taahhüt etmeden önce doğrulamanız gerekenler. Hesabınızın gerekli model kimliğine erişebildiğini doğrulayın, mevcut fiyat ve hız sınırlarını gözden geçirin ve küçük bir kimliği doğrulanmış test çalıştırın. Üretim iş akışını eski bir blog yazısında veya önbelleğe alınmış bir örnekte gördüğünüz bir modele göre tasarlamayın.

Başlamadan önce

CometAPI hesabına, sunucunuzda saklanan bir API anahtarına ve asenkron bir işi çalıştırabilen bir arka uca ihtiyacınız var. Anahtarı COMETAPI_KEY gibi bir ortam değişkeninde tutun; tarayıcı veya mobil istemci kodunda göstermeyin.

1. Kling model kataloğunu açın ve kullanmayı düşündüğünüz modelin hesabınız için şu anda listelendiğini doğrulayın.
2. Güncel Kling metinden videoya API referansını inceleyin. Doğrulama sırasında, belgelenmiş örnek kling-v3 kullanıyor.
3. CometAPI konsolunda sunucu tarafı bir API anahtarı oluşturun ve çalışma zamanı ortamınıza yerleştirin.
4. Hizmetinizin görev kimliğini ve nihai videoyu nerede depolayacağını belirleyin. Oluşturma isteği bir görev döndürür, bitmiş video dosyasını değil.

İsteği tasarlamadan önce Kling iş akışını seçin

Ürününüzün zaten sahip olduğu varlıktan yola çıkın. Kullanıcının yalnızca yazılı bir fikri varsa, metinden videoya doğrudan yoldur. Kullanıcının görsel ankraj olarak korunması gereken bir durağan görüntüsü varsa, ayrı olarak belgelenen görüntüden videoya yolunu kullanın. Metinden videoya isteğine bir görüntü alanı ekleyip API’nin iş akışını çıkarım yapacağını varsaymayın.

Güncel görüntüden videoya referansı herkese açık bir görüntü URL’sini veya base64 görüntü dizgesini kabul eder ve asenkron bir görev döndürür. Daha özel Kling iş akışlarının kendi sayfaları ve istek kısıtları vardır. Ürün gereksinimi ve güncel dokümantasyon ek adaptörü haklı çıkardığında bunları birer birer ekleyin.

İlk üretim doğrusu için tek bir iş akışı, doğrulanmış bir model kimliği, kısa bir süre ve temsil gücü olan küçük bir komut kümesi kullanın. Bu, hesap erişimini ve görev orkestrasyonunu öznel çıktı değerlendirmesinden izole eder. Boru hattı güvenilir olduğunda, aynı testte birden fazla değişkeni değiştirmek yerine sabit bir değerlendirme setiyle kipleri veya modelleri karşılaştırın.

İlk Kling metinden videoya isteğinizi oluşturun

Geçerli metinden videoya uç nokta JSON kabul eder ve Bearer kimlik doğrulaması kullanır. Kısa bir komut ve desteklenen en küçük süreyle başlayın. Aşağıdaki istek, yalnızca mevcut CometAPI referansında gösterilen alanları kullanır:

curl https://api.cometapi.com/kling/v1/videos/text2video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A small ceramic cup on a wooden table, steam rising in soft morning light",
    "model_name": "kling-v3",
    "mode": "std",
    "duration": "5",
    "sound": "off"
  }'

Başarılı bir gönderim data.task_id ve bir görev durumunu içeren bir nesne döndürür. Bu görev kimliğini uygulamanızın iş kaydıyla birlikte saklayın. Video oluşturulurken HTTP bağlantısını açık tutmayın.

Asenkron görevi güvenle yönetin

Kling oluşturma asenkron çalışır. Metinden videoya için GET /kling/v1/videos/text2video/{task_id} ile yoklama yapın. CometAPI’nin görev referansı, bir yanıtın görevi doğrudan veya data zarfı içinde döndürebileceğini söyler; bu nedenle örnek her iki biçimi de normalize eder. Ayrıca sabit bir ara durum listesi varsaymak yerine, her terminal olmayan durumu “beklemeye devam et” olarak ele alır.

import os
import time
import requests

API_KEY = os.environ["COMETAPI_KEY"]
BASE_URL = "https://api.cometapi.com/kling/v1/videos/text2video"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}


def submit_video(prompt: str) -> str:
    response = requests.post(
        BASE_URL,
        headers=HEADERS,
        json={
            "prompt": prompt,
            "model_name": "kling-v3",
            "mode": "std",
            "duration": "5",
            "sound": "off",
        },
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()
    return payload["data"]["task_id"]


def wait_for_video(task_id: str, timeout_seconds: int = 600) -> str:
    deadline = time.monotonic() + timeout_seconds
    poll_url = f"{BASE_URL}/{task_id}"

    while time.monotonic() < deadline:
        response = requests.get(poll_url, headers=HEADERS, timeout=30)
        response.raise_for_status()
        payload = response.json()
        task = payload.get("data") or payload
        status = task.get("task_status")

        if status == "succeed":
            videos = task.get("task_result", {}).get("videos", [])
            if not videos or not videos[0].get("url"):
                raise RuntimeError("Task succeeded without a video URL")
            return videos[0]["url"]

        if status == "failed":
            detail = task.get("task_status_msg") or task.get("task_result")
            raise RuntimeError(f"Kling task failed: {detail}")

        time.sleep(10)

    raise TimeoutError(f"Kling task {task_id} exceeded {timeout_seconds}s")


task_id = submit_video(
    "A small ceramic cup on a wooden table, steam rising in soft morning light"
)
video_url = wait_for_video(task_id)
print(video_url)

Terminal başarı dizgesi succeedtir, succeeded değildir. Bir görev tamamlandığında, ürününüz saklama gerektiriyorsa oluşturulan varlığı kontrolünüz altındaki depolamaya kopyalayın. Sağlayıcı teslimat URL’leri kalıcı uygulama depolaması olarak değerlendirilmemelidir.

Daha büyük iş yükleri için bir web isteği içinde yoklama yapmak yerine bir kuyruk veya işçi kullanın. CometAPI ayrıca Kling görevleri için geri çağrı (callback) URL’lerini belgeliyor. Webhook’ları benimserseniz, geri çağrı olaylarını kimlik doğrulayın ve yinelenmeyecek şekilde işleyin; kaçırılan teslimatlar için de bir yoklama geri dönüşü (fallback) bulundurun.

Ölçeklemeden önce uygulama iş yaşam döngüsünü tasarlayın

Sağlayıcı görevini kendi iş kaydınızın bir parçası olarak ele alın. Bir uygulama iş kimliği, iş akışı, istenen model, sağlayıcı görev kimliği, sorgu URL’si, mevcut durum, gönderim zaman damgası, son yoklama zamanı ve çıktı konumunu saklayın. Bu, destek ve operasyon ekiplerinize, ham istek günlüklerini aramadan başarısız veya yavaş bir oluşturmayı incelemek için yeterli bağlam sağlar.

İstemci yanıtı almadı diye oluşturma isteğini yeniden denemeyin. Sağlayıcı zaten bir görev oluşturmuş olabilir. Yerel işinizi gönderimden önce kalıcı hale getirin, dönen görev kimliğini hemen kaydedin ve oluşturma yeniden denemelerini durum sorgulama yeniden denemelerinden ayırın. Mevcut metinden videoya referansı ayrıca uygulama takibi için external_task_idyi belgeliyor; bunu bir yinelenmeyi önleme mekanizması olarak kullanmadan önce canlı davranışını doğrulayın.

const TERMINAL = new Set(["succeed", "failed"]);

function normalizeKlingTask(payload) {
  const task = payload?.data ?? payload;
  if (!task?.task_id || !task?.task_status) {
    throw new Error("Kling response is missing task identity or status");
  }
  return task;
}

async function refreshVideoJob(job, apiKey) {
  const response = await fetch(job.queryUrl, {
    headers: { Authorization: `Bearer ${apiKey}` },
  });

  if (!response.ok) {
    throw new Error(`Task query failed with HTTP ${response.status}`);
  }

  const task = normalizeKlingTask(await response.json());
  const outputUrl = task.task_result?.videos?.[0]?.url ?? null;

  return {
    ...job,
    providerTaskId: task.task_id,
    providerStatus: task.task_status,
    terminal: TERMINAL.has(task.task_status),
    outputUrl,
    failureDetail: task.task_status_msg ?? null,
    checkedAt: new Date().toISOString(),
  };
}

Bu örnek, sağlayıcının her olası ara durumunu ürün vaadine çevirmeyi özellikle yapmaz. İşçiniz terminal olmayan görevleri aktif tutar, succeed ve failed durumlarını açıkça işler ve hata ayıklama için ham sağlayıcı durumunu kaydeder. Ayrı bir uygulama zaman aşımı ekleyin ki takılmış bir görev sonsuza dek açık kalmasın.

Temel yol olarak yoklamayı kullanın çünkü görev kimliği sorgulanabilir durumda kalır. Seçilen uç nokta callback_url desteklediğinde bir webhook yinelenen durum isteklerini azaltabilir, ancak tek kurtarma mekanizmanız haline gelmemelidir. Resmî yoklama ve webhook rehberi, geri çağrı yüklerinin sağlayıcıya özgü olabileceğini belirtir. Ham olayı saklayın, görev kimliğine göre işlemi idempotent yapın, başarılı HTTP yanıtını hızlıca döndürün ve terminal durumu yoklama ile uzlaştırın.

Geliştirme ekipleri için üretim kontrol listesi

• Çalışma zamanında modeli doğrulayın. Mevcut kataloğu kontrol edin ve istenen model kullanılamadığında net şekilde hata verin. Çıktı davranışı önemliyse farklı bir modeli sessizce ikame etmeyin.
• Gönderimi almadan ayırın. CometAPI görev kimliğini, kendi iş kimliğinizi, seçili modeli ve zaman damgalarını saklayın ki yeniden denemeler mükerrer iş yaratmasın.
• Yoklamayı sınırlayın. Bir zaman aşımı, üstel geri çekilme veya makul bir sabit aralık ve azami deneme sayısı kullanın. Paralelliği artırmadan önce CometAPI’nin hız sınırı ve eşzamanlılık rehberini gözden geçirin.
• Hataları sınıflandırın. Geçersiz parametreleri veya kimlik doğrulama hatalarını yeniden denemeyin. Güncel yeniden deneme rehberini izleyerek, yeniden denemeye uygun hız sınırı ve platform hatalarına geri çekilme uygulayın.
• Kimlik bilgilerini ve girdileri koruyun. API anahtarlarını sunucu tarafında tutun, gizli bilgileri günlüklemeyin ve kullanıcıların gönderdikleri komutlar, görüntüler veya diğer kaynak varlıklar üzerinde hakları olduğundan emin olun.
• Tüm işi ölçün. Gönderim başarısı, kuyruk süresi, oluşturma süresi, terminal hata oranı, zaman aşımı oranı, çıktı alma başarısı ve maliyeti model ve kip bazında takip edin.
• Çıktıları bilinçli olarak kalıcılaştırın. Ürününüz kalıcı erişim gerektiriyorsa tamamlanan varlıkları kendi kontrolünüzdeki depolamaya indirin, ardından saklama ve silme politikanızı uygulayın.

Pratik SSS

Bu yol için ayrı bir Kling geliştirici hesabına ihtiyacım var mı?

CometAPI’nin entegrasyon akışında ayrı bir Kling geliştirici onboarding adımı görünmüyor. CometAPI hesabı ve API anahtarı kullanırsınız. Erişim yine de CometAPI hesabınıza ve bölgenize tanımlı model kullanılabilirliğine bağlıdır; üretime geçmeden önce bunu doğrulayın.

Kling API’si tamamen OpenAI ile uyumlu mu?

Burada gösterilen video iş akışı için hayır. /kling/v1/videos/text2video gibi Kling’e özgü rotalar ve Kling’e özgü alanlar kullanır. Kimlik bilgisini CometAPI üzerinden yönetebilirsiniz, ancak adaptörünüz sağlayıcıya özgü şemayı korumalıdır.

Hangi Kling model kimliğini kullanmalıyım?

Geçerli CometAPI metinden videoya referansı ilk çalışan örneğinde kling-v3 kullanır ve birkaç önceki model izini listeler. Canlı uç nokta enum’undaki bir model kimliğini kullanın ve hesabınız için etkin olduğunu doğrulayın. En yeni modelin her yerde kullanılabilir olduğunu varsaymayın.

İlk yanıt neden bir video içermiyor?

Video oluşturma asenkron bir görev olarak çalışır. İlk yanıt bir görev kimliği döndürür. task_status succeed veya failed olana kadar eşleşen sorgu rotasını yoklayın, ardından sonuç metaverilerini okuyun.

Yoklama mı yapmalıyım yoksa bir callback URL mi kullanmalıyım?

İlk entegrasyon için yoklama daha kolaydır. Geri çağrılar (callback) ölçekte tekrarlanan istekleri azaltır ancak kimliği doğrulanmış, idempotent bir alıcı ve kurtarma mantığı gerektirir. Birçok üretim sistemi geri çağrıları birincil yol, yoklamayı ise geri dönüş olarak kullanır.

Aynı uç nokta üzerinden görüntüden videoya kullanabilir miyim?

Hayır. CometAPI, görüntüden videoyu ayrı bir rota altında belgeliyor: /kling/v1/videos/image2video. Metinden videoya örneğine bir görüntü alanı eklemek yerine o uç noktanın güncel istek şemasını izleyin.

Standart mı yoksa profesyonel modla mı başlamalıyım?

Kimlik doğrulama, istek biçimi, görev depolama, yoklama ve çıktı alma adımlarını doğrulamak için std ile başlayın. Güncel referans pro kipini daha yüksek kalite ve daha yüksek maliyet olarak açıklar. Temel iş akışı çalıştıktan sonra temsil gücü olan komutlarla değerlendirin ve oluşturma süresi ile gerçek maliyeti birlikte karşılaştırın.

Tekrar denemelerde yinelenen oluşturmalardan nasıl kaçınabilirim?

API’yi çağırmadan önce bir uygulama iş kaydı oluşturun ve dönen sağlayıcı görev kimliğini hemen kaydedin. Durum sorgulama yeniden denemelerini oluşturma yeniden denemelerinden bağımsız hale getirin. Aynı POST’un idempotent olduğunu varsaymayın. Uç nokta şu anda takip için external_task_idyi belgeliyor, ancak bunu bir yinelenmeme garantisi olarak görmeden önce güncel davranışını doğrulayın.

Sonuç

Ayrı bir doğrudan Kling geliştirici başvurusu tamamlamadan Kling video oluşturmayı test etmek isteyen bir ABD geliştirme ekibi için CometAPI belgelenmiş bir yol sunar: gerekli Kling modelinin hesap için kullanılabilir olduğunu doğrulayın, CometAPI anahtarıyla kimlik doğrulayın, iş akışına özgü uç noktayı çağırın ve asenkron görevi terminal duruma ulaşana kadar takip edin.

Pratik mühendislik değeri, tüm video sağlayıcılarının aynı şekilde davrandığını varsaymak değil; merkezi erişim ve yeniden kullanılabilir bir uygulama iş modelidir. Her iş akışı için ince bir adaptörü koruyun, görev kimliğini ve çıktıyı bilinçli şekilde kalıcılaştırın ve geri çağrılar etkinleştirildiğinde bile yoklamayı bir kurtarma yolu olarak tutun.

Güvenli bir yayılım küçük ve ölçülebilirdir: tek bir modeli ve tek bir iş akışını doğrulayın, kısa ve düşük maliyetli işler gönderin, terminal başarı ve hata oranlarını kaydedin, çıktı alımını doğrulayın ve gerçek maliyet ile gecikmeyi ürün gereksinimlerinizle karşılaştırın. Görüntüden videoya veya ek Kling iş akışlarına yalnızca güncel dokümantasyon ve hedef hesabınız kontrol edildikten sonra genişleyin.