Ana içeriğe atla

Genel Bakış

LemonData, tek bir birleşik API aracılığıyla 11 sağlayıcıdan 69’dan fazla video üretim modeline erişim sağlar. Video üretimi asenkron çalışır — bir istek gönderir ve bir görev kimliği (task_id) alırsınız, ardından sonucu kontrol edersiniz (poll).
Model listesi sık sık güncellenmektedir. Mevcut en güncel modeller ve fiyatlandırma için Modeller sayfasını ziyaret edin veya Modeller API’sini kullanın.

Asenkron İş Akışı

import requests
import time

API_KEY = "sk-your-api-key"
BASE = "https://api.lemondata.cc/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Adım 1: Üretim isteğini gönder
resp = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.6-pro",
        "prompt": "A golden retriever running on a beach at sunset, cinematic 4K",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
)
task_id = resp.json()["task_id"]

# Adım 2: Sonuç için sorgula
while True:
    status = requests.get(f"{BASE}/videos/generations/{task_id}", headers=headers).json()
    if status["status"] in ("completed", "succeeded"):
        print(f"Video URL: {status['video_url']}")
        break
    elif status["status"] == "failed":
        print(f"Failed: {status.get('error')}")
        break
    time.sleep(10)

Model Yetenek Matrisi

Farklı modeller farklı görevlerde uzmanlaşmıştır. Kullanım durumunuz için doğru modeli seçmek için bu matrisi kullanın. Açıklama: ✅ Destekleniyor | ❌ Desteklenmiyor
SeriSağlayıcıT2VI2VAnahtar KareUzatmaDüzenlemeMaks. Süre
SoraOpenAI~20s
KlingKuaishou10s
VeoGoogle8s
SeedanceByteDance10s
HailuoMiniMax6s
WanAlibaba5s
RunwayRunway10s
LumaLuma5s
ViduVidu8s
GrokxAI~10s
HiggsfieldHiggsfield~5s

Yetenek Tanımları

  • T2V (Metinden Videoya): Bir metin isteminden video üretin
  • I2V (Görselden Videoya): image_url veya image kullanarak statik bir görseli videoya dönüştürün
  • Anahtar Kare (Keyframe): start_image + end_image ile başlangıç ve bitiş karelerini kontrol edin
  • Uzatma (Extension): Mevcut bir videonun süresini uzatın
  • Düzenleme (Editing): Mevcut bir videonun belirli yönlerini değiştirin

Serilere Göre Mevcut Modeller

Sora (OpenAI)

ModelKaliteNotlar
sora-2StandartVarsayılan model, kalite ve hız arasında iyi denge
sora-2-proYüksekDaha yüksek kalite, daha uzun üretim süresi
sora-2-charactersStandartKarakter odaklı üretim

Kling (Kuaishou)

ModelYetenekNotlar
kling-v2.6-proT2VEn son nesil, profesyonel kalite
kling-v2.6-stdT2VEn son nesil, hızlı
kling-v2.5-turbo-proT2VTurbo hız, profesyonel kalite
kling-v2.1-masterT2V/I2VMaster kalite
kling-v2.1-proT2V/I2VProfesyonel kalite
kling-v2.1-standardT2V/I2VStandart kalite
kling-videoT2V/I2VTemel model
kling-video-extendUzatmaMevcut videoları uzatın
kling-video-o1-proT2VO1 muhakeme, profesyonel kalite
kling-video-o1-stdT2VO1 muhakeme, standart
kling-effectsEfektlerGörsel efektler uygulayın
kling-omni-videoT2VOmni model
kling-motion-controlT2VHareket kontrollü üretim

Veo (Google)

ModelKaliteNotlar
veo3.1StandartGoogle’ın en yeni video modeli
veo3.1-proYüksekProfesyonel kalite
veo3.1-4kUltra4K çözünürlük çıktısı
veo3.1-fastHızlıDaha hızlı üretim
veo3.1-fast-4kHızlı + 4K4K çıktı ile hızlı üretim
veo3.1-componentsStandartBileşen tabanlı üretim
veo3StandartÖnceki nesil
veo3-proYüksekÖnceki nesil, profesyonel
veo3-fastHızlıÖnceki nesil, hızlı

Seedance (ByteDance)

ModelYetenekNotlar
seedance-2-0T2V/I2V/Keyframe/Extension/EditingEn yeni, en yetenekli
seedance-1-5-proT2V/I2VÖnceki nesil, profesyonel kalite
seedance-1-0-proT2V/I2VBirinci nesil, profesyonel
seedance-1-0-pro-fastT2V/I2VBirinci nesil, hızlı
seedance-1-0-lite-t2vT2VHafif metinden videoya
seedance-1-0-lite-i2vI2VHafif görselden videoya
Seedance 2.0, çok modludan videoya, video uzatma ve video düzenleme dahil olmak üzere en geniş yetenek yelpazesini — tamamını aynı API uç noktası üzerinden — destekler.

Hailuo (MiniMax)

ModelKaliteNotlar
hailuo-2.3Standartİyi kalite
hailuo-2.3-proYüksekDaha yüksek kaliteli çıktı
hailuo-2.3-fastHızlıDaha hızlı üretim
hailuo-2.3-standardStandartStandart katman
video-01StandartMiniMax video-01
video-01-liveStandartCanlı stil üretim

Wan (Alibaba)

ModelYetenekNotlar
wan-2.6T2VEn yeni metinden videoya
wan2.6-i2vI2VEn yeni görselden videoya
wan-2.5T2VÖnceki nesil
wan2.5-i2v-previewI2VÖnceki nesil I2V
wan-2.2-plusT2VDaha eski nesil
vace-14bT2VVACE mimarisi

Runway

ModelSüreNotlar
runwayml-gen4-turbo-55sHızlı üretim
runwayml-gen4-turbo-1010sDaha uzun klipler

Luma

ModelYetenekNotlar
luma-video-apiT2VMetinden videoya
luma-video-extend-apiUzatmaMevcut videoları uzatın

Vidu (Shengshu)

ModelKaliteNotlar
viduq3-proYüksekEn son nesil
viduq2-proYüksekÖnceki nesil, profesyonel
viduq2-pro-fastHızlıÖnceki nesil, hızlı profesyonel
viduq2StandartÖnceki nesil, standart
viduq2-turboHızlıTurbo hız
vidu2.0StandartTemel model

Grok (xAI)

ModelNotlar
grok-video-3xAI’ın video üretim modeli
grok-video-3-10s10 saniyelik varyant

Higgsfield

ModelNotlar
higgsfield-turboEn hızlı, daha düşük maliyet
higgsfield-standardStandart kalite
higgsfield-liteHafif

Kullanım Örnekleri

Metinden Videoya (T2V)

En yaygın kullanım durumu. Tüm modeller bunu destekler.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "veo3.1-pro",
        "prompt": "Aerial drone shot of a coastal city at golden hour, waves crashing against cliffs",
        "duration": 5,
        "aspect_ratio": "16:9",
        "resolution": "1080p"
    }
)

Görselden Videoya (I2V)

Statik bir görseli hareketlendirin. Bir URL için image_url veya base64 verisi için image kullanın.
# Görsel URL'si kullanarak
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "wan2.6-i2v",
        "prompt": "The person slowly turns and smiles at the camera",
        "image_url": "https://example.com/portrait.jpg"
    }
)

# base64 görsel kullanarak
import base64
with open("photo.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.1-master",
        "prompt": "Gentle wind blows through the scene",
        "image": f"data:image/jpeg;base64,{image_b64}"
    }
)

Anahtar Kare Kontrolü (Başlangıç + Bitiş Görseli)

Hassas geçişler için hem ilk hem de son kareleri kontrol edin. Şu anda Seedance 2.0 tarafından desteklenmektedir.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "seedance-2-0",
        "prompt": "Smooth transition from day to night, city lights gradually turning on",
        "start_image": "https://example.com/city-day.jpg",
        "end_image": "https://example.com/city-night.jpg",
        "duration": 5
    }
)

Video Uzatma

Mevcut bir videonun süresini uzatın. Uzatma yeteneği olan modelleri kullanın.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-video-extend",
        "prompt": "Continue the scene naturally",
        "image_url": "https://example.com/last-frame.jpg"
    }
)

Parametre Referansı

ParametreTürAçıklama
modelstringModel kimliği (varsayılan: sora-2)
promptstringGerekli. Videonun metin açıklaması
image_urlstringBaşlangıç görselinin URL’si (I2V için)
imagestringVeri URL’si öneki ile base64 kodlu görsel (I2V için)
durationintegerSaniye cinsinden video süresi (1-60, modele bağlıdır)
aspect_ratiostring16:9, 9:16, 1:1, vb.
resolutionstring1080p, 720p, 4k
fpsintegerSaniye başına kare sayısı (1-120)
negative_promptstringÜretimde nelerden kaçınılacağı
seedintegerTekrarlanabilirlik için rastgele tohum (seed)
cfg_scalenumberYönlendirme ölçeği (0-20)
motion_strengthnumberHareket yoğunluğu (0-1)
start_imagestringBaşlangıç anahtar karesinin URL’si
end_imagestringBitiş anahtar karesinin URL’si
Tüm parametreler her model tarafından desteklenmez. Desteklenmeyen parametreler sessizce yoksayılır. Desteklenen parametreler için modelin dokümantasyonunu kontrol edin.

Model Seçim Rehberi

En İyi Kalite

Seedance 2.0 veya Kling v2.6 Pro — sinematik kalite, zengin detay, doğal hareket

En Hızlı Üretim

Higgsfield Turbo veya Hailuo 2.3 — prototipleme ve yineleme için hızlı sonuçlar

En Çok Yönlü

Seedance 2.0 — tek bir modelde T2V, I2V, anahtar kare, uzatma ve düzenlemeyi destekler

En İyi Değer

Wan 2.6 veya Hailuo 2.3 — üretim başına daha düşük maliyetle rekabetçi kalite

Faturalandırma

Video üretimi üretim başına sabit fiyatlandırma kullanır. Video süresinden bağımsız olarak, görev gönderildiğinde bir kez ücretlendirilirsiniz. Üretim başarısız olursa, ücret otomatik olarak iade edilir. Güncel fiyatlandırmayı Modeller sayfasından veya Fiyatlandırma API’si aracılığıyla kontrol edin.