Kling V4 Flash

2026-11-07 tarihinde doğrulanan APIMaster kling-v4-flash sözleşmesi. Kanal 317: metin, ilk kare, referanslar, düzenleme ve uzatma. Yalnız 720p, 24 fps, 3–20 saniye; Kling V4'ten ayrı modeldir.

Kling V4 Flash

Uç noktalar ve kimlik doğrulama

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

Parametreler

JSON ve Authorization: Bearer YOUR_API_KEY kullanın; model=kling-v4-flash. Tek başlangıç görseli dışında prompt zorunlu. duration/seconds: JSON tam sayı 3–20, varsayılan 5; null atlanmış sayılır, 0 reddedilir. İkisi de verilirse geçerli ve eşit olmalıdır. Süresiz düzenleme, giriş video akışının yukarı yuvarlanmış süresini kullanır. resolution yalnız 720p. aspect_ratio veya size: 16:9, 9:16, 1:1, 21:9; auto sadece referansta. Varsayılan metin 16:9, referans auto, düzenleme kaynağı izler. İlk görsel ve uzatma boş olmayan aspect_ratio/size kabul etmez. audio yalnız true, watermark yalnız false.

Parametre	JSON türü	Gerekli	Varsayılan	İşlev ve sınırlar
model	string	Evet	kling-v4-flash	Beş işlemin tümünde kling-v4-flash kullanılır; kling-v4 ayrı bir modeldir.
prompt	string	Moda göre	—	Sahne, hareket veya değişikliği açıklar. Yalnızca tek başlangıç görselinde isteğe bağlıdır. @Image1 ve @Video1 her dizinin sırasına göre ayrı ayrı 1’den numaralanır; düzenlenen video @Video1 olur.
duration	integer / null	Hayır	5	3–20 JSON tam sayı saniye, genellikle 5. Düzenlemede iki süre alanı da atlanırsa kaynak video akışı süresi yukarı yuvarlanır; uzatmada YENİ bölümün süresidir. null atlanmış sayılır; 0, tam sayı olmayan değerler ve sayı dizgeleri reddedilir.
seconds	integer / null	Hayır	—	duration takma adı, aynı sınırlar. Tek alan önerilir; ikisi birlikte gönderilirse geçerli ve eşit olmalı, aksi halde 400.
resolution	string	Hayır	720p	Yalnızca 720p. Kalite kademesidir; kısa kenarın mutlaka 720px olduğu anlamına gelmez. 1080p ve mode ile kalite seçimi desteklenmez.
aspect_ratio	string	Hayır	Moda göre	Metin/referans/düzenleme: 16:9, 9:16, 1:1, 21:9; auto yalnızca referans için. Varsayılan metin 16:9, referans auto, düzenleme kaynağa göre. Başlangıç görseli/uzatma boş olmayan değeri reddeder; boş dizge atlanır.
size	string	Hayır	—	aspect_ratio takma adıdır, çözünürlük veya piksel boyutu değildir. İkisi birlikteyse aynı olmalıdır. Başlangıç görseli ve uzatmada ikisini de atlayın.
image_urls	string[]	Moda göre	—	Herkese açık görsel URL dizisi. Auto yalnızca bir başlangıç görseli alır; yalnızca görsellerden referans için açık reference gerekir. Referans/düzenleme en fazla 10 görsel, reference_image rolleri dahil. Başlangıç görseli gösterimlerini karıştırmayın; uzatma görsel almaz.
first_frame_image	string	Moda göre	—	Tek başlangıç görselinin herkese açık URL’si; bir image_urls öğesi veya first_frame rolüne alternatiftir. Her iki boyut ≥300px, oran 2:5–5:2; gerekirse önce kırpın.
image_with_roles	{url, role}[]	Moda göre	—	Her nesnede herkese açık url ve role gereklidir. first_frame tek başlangıç karesi, reference_image referans/düzenleme içindir. Son/ara/anahtar kare desteklenmez. Referans görselleri≤10, görsel/video referansları toplam≤15.
video_url	string	Moda göre	—	Açık edit/extend ile tek kaynak video URL’si, video_urls ile birlikte kullanılamaz. Düzenleme: MP4/MOV, video akışı 3–20s, her boyut 700–4553px. Uzatma son kareden başlar, yalnızca yeni bölümü döndürür; görev/konuşma ID’si kabul etmez.
video_urls	string[]	Moda göre	—	En fazla 5 MP4/MOV referansı, her akış≥3s, her boyut 700–4553px, toplam≤20s. Açık edit/extend için tek öğe video_url yerine kullanılabilir. Sınır aşımı kırpılmaz, reddedilir; dizi referans modunu otomatik seçer.
omni_reference_task_type	string	Hayır	auto	auto metin/başlangıç görseli/referansı belirler; reference referans materyali, edit/extend tek video gerektirir. Açık mod olmadan video_url ve auto içinde iki normal görsel geçersizdir.
audio_setting	string	Hayır	auto	Yalnızca VİDEOLU referans. auto sesi yeniden üretir; origin İLK referansın sesini korur, kaynakta ses izi yoksa çıktıda da olmaz. Düzenleme, uzatma, metin ve yalnızca görsel referansta atlayın.
audio	boolean	Hayır	true	Uyumluluk boolean: atlayın veya true gönderin; false reddedilir. Özgün ses için desteklenen modda audio_setting kullanın; ayrı ses referansı desteklenmez.
watermark	boolean	Hayır	false	Uyumluluk boolean: atlayın veya false gönderin; true reddedilir. Kaynak filigranını silme hizmeti değildir.

Gömülü kimlik bilgisi olmayan herkese açık doğrudan HTTP(S) URL kullanın; base64/yerel yol/görev ID’si değil. Görsel biçimi ve bayt sınırı ayrıca yayımlanmamıştır. 100MiB, incelenen her referans/düzenleme videosunun okuma sınırıdır; genel sağlayıcı yükleme sınırı değildir.

Modlar ve medya

İşlem	Seçim ve gerekli materyal	Varsayılanlar ve dışlananlar
Metinden video	Materyal yok, prompt zorunlu, tür auto veya atlanmış.	5s, 16:9; audio_setting yok.
Başlangıç görselinden video	Üç gösterimden BİRİ ile tek görsel, prompt isteğe bağlı.	5s, görsel oranı; aspect_ratio/size ve son kare yok.
Referanstan video	reference + görseller, reference_image rolleri veya video_urls; prompt zorunlu.	5s, auto; görseller≤10, videolar≤5, toplam≤15; ses seçeneği video gerektirir.
Video düzenleme	edit + tek video, prompt zorunlu; en fazla 10 referans görseli.	Kaynak süresi yukarı yuvarlanır, kaynak oranı; kare rolleri/audio_setting yok.
Video uzatma	extend + tek video, prompt zorunlu.	5 YENİ saniye; görsel, oran değiştirme/audio_setting yok; düzenleme/referansın asgari boyut/süre kontrolü uygulanmaz.

omni_reference_task_type: auto, reference, edit, extend. Bir image_urls, first_frame_image veya first_frame rolü başlangıç karesidir. Çoklu görsel için reference veya reference_image rolleri gerekir; auto ile iki image_urls reddedilir. video_urls, edit/extend açık değilse referans modudur. video_url edit/extend gerektirir ve video_urls ile kullanılamaz. Düzenleme/uzatma tek video gerektirir. Düzenleme referans görseller alabilir; uzatma görsel/audio_setting almaz ve yalnız YENİ bölümü döndürür. Kaynak videonun açık URL'sini kullanın; görev veya konuşma ID'si göndermeyin.

Kimlik bilgisi içermeyen doğrudan açık HTTP(S) URL'ler. En fazla 10 görsel, toplam 15 görsel/video referansı. Görseller en az 300×300, oran 2:5–5:2. En fazla 5 MP4/MOV, her biri en az 3 saniye, toplam en çok 20; düzenleme tek 3–20 saniye video. Genişlik VE yükseklik 700–4553 piksel. Ağ geçidi video başına en fazla 100 MiB okur, kapsayıcı/ses yerine video akışını ölçer. Boyut/asgari süre kontrolleri uzatma girdisine uygulanmaz. Sağlayıcı görselleri de doğrular. audio_setting=origin ilk video referansının sesini veya sessizliği korur; auto ses üretir. Yalnız videolu referanslarda. Düzenleme sesi yeniden üretir. Ses URL'leri, son/ara kareler, keyframes, negative_prompt, mode, seed, çoklu sahne ve kişi/ses listeleri desteklenmez.

Çıktı pikselleri ve kare hızı

Oran / işlem	Belgelenen çıktı pikselleri	Kare hızı
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
Başlangıç görselinden video	Görsel oranı, yaklaşık 0,92MP; örneğin 2:5 için 604×1516.	24 fps

Çıktı boyutları giriş şartı değildir. 21:9 yüksekliği 628px olup referans/düzenleme için 700px altındadır; uygun kaynak hazırlayın. Bu minimum uzatmada uygulanmaz. Dosya yaklaşık bir kare uzun olabilir.

Çalıştırılmayan örnekler

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

Ücret hesabı

Resmî nominal temel fiyat: çıkış saniyesi $0.094 (720P), videolu faturalandırma saniyesi $0.0628 (720P-input). Metin, görsel, videosuz referans ve uzatma: çıkış/yeni bölüm. Video referansı ve düzenleme: çıkış + max(giriş, çıkış). Önce tüm giriş video akış sürelerini toplayın, sonra toplamı saniyeye yukarı yuvarlayın. Giriş 3.04, çıkış 3 saniye: 3+max(4,3)=7 faturalandırma saniyesi. Ek bir kare, istenen tam sayı çıkış süresini değiştirmez. Paket indirimleri ve hesap çarpanları ayrıdır; kart ve son tüketim kaydı esas alınır. Kesinleşen üretim hatası rezervi iade eder. Sorgulamayı bırakmak iptal değildir; belirsiz timeout yeni üretimi haklı çıkarmaz.

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

Durum, hatalar ve güvenli yeniden deneme

İlk kabul: HTTP 200, açık task_id, queued. GET /v1/videos/{task_id}: queued/in_progress/completed/failed, geçici unknown olabilir. url ve metadata.url Bearer ister; GET /v1/videos/{task_id}/content da kullanılabilir. Hata: error.code=generation_failed ve temizlenmiş ileti; hatalı parametre: HTTP 400. Idempotency-Key: boşluksuz 8–128 görünür ASCII. Aynı hesap/anahtar/istek: HTTP 202, ikinci üretim/rezerv yok; değişiklik: 409. GET /v1/video-submissions/by-key makbuzu okur. accepted+task_ready=true: task_id sorgulayın; pending/submitting veya hazır değil: bekleyin. acceptance_unknown: anahtarı saklayıp desteğe başvurun, otomatik yeniden göndermeyin. 404 kabul edilmediğini kanıtlamaz. En az 30 gün saklanır; sağlayıcı araması değil ağ geçidi korumasıdır. Son ücret other.task_id ile tüketim günlüğünde; görev sorgusu son fatura garantilemez. /v1/videos/quote desteklenmez. Örnekler çalıştırılmaz: URL'leri değiştirin, yeni işleme yeni anahtar kullanın.

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI