Ana içeriğe atla

​
Genel bakış

Video üretimi asenkron çalışır. Bir istek gönderirsiniz, task_id ve poll_url alırsınız, ardından nihai sonuç hazır olana kadar durumu düzenli olarak sorgularsınız.
Oluşturma yanıtı kanonik asenkron kimlik olarak id döndürür ve çoğu zaman bunu task_id içinde de tekrar eder. Önce poll_url adresini izleyin; sabit bir durum uç noktası gerekiyorsa GET /v1/tasks/{id} kullanın.
Bir create yanıtı poll_url döndürürse, tam olarak o URL’yi çağırın. Bu URL /v1/tasks/{id} adresine işaret ediyorsa, onu kanonik sabit durum uç noktası olarak kabul edin.
En güvenilir durum sorgulaması için oluşturma yanıtında dönen poll_url değerini aynen kullanın.
Ses çıkışı modele bağlıdır. LemonData’da output_audio gönderilmezse Veo 3 ailesi varsayılan olarak sesi açık kabul eder. Bir model ses kontrolünü destekliyorsa bunu açıkça yönetmek için output_audio kullanın. CamelCase takma adı outputAudio da uyumluluk için kabul edilir.
Üretim entegrasyonlarında görsel, video ve ses girdileri için herkese açık https URL’leri tercih edin. Uyumlu modeller data: URL’lerini kabul etmeye devam eder, ancak büyük base64 yüklerini yeniden denemek, incelemek ve hata ayıklamak daha zordur.

​
İstek gövdesi

​
model
string
varsayılan:"sora-2"
Video model kimliği. API varsayılanı sora-2’dir. Güncel herkese açık model matrisi ve desteklenen yetenekler için video oluşturma kılavuzuna bakın.
​
prompt
string
gerekli
Oluşturulacak videonun metin açıklaması. Bu alan herkese açık video modellerinin çoğunda zorunludur.
​
operation
string
Çalıştırılacak video işlemi. Herkese açık sözleşme text-to-video, image-to-video, reference-to-video, start-end-to-video, video-to-video, video-extension, audio-to-video ve motion-control değerlerini destekler. LemonData işlemi gönderdiğiniz girdilerden çıkarabilir, ancak üretimde operation değerini açıkça göndermeniz önerilir.
​
image_url
string
Image-to-video akışı için başlangıç görselinin herkese açık URL’si. Modeller arası en geniş uyumluluk için image_url tercih edilmelidir.
​
image
string
data: URL biçiminde satır içi görsel (örneğin data:image/jpeg;base64,...). Uyumlu modeller bunu destekler, ancak üretimde genellikle image_url daha sağlamdır.
​
reference_images
array
Reference-to-video akışları için referans görseller. En fazla 3 öğe gönderilebilir. Herkese açık https URL’leri önerilir; uyumlu modeller data: URL’lerini de kabul eder.
​
reference_image_type
string
asset ve style referanslarını ayıran modeller için isteğe bağlı alandır.
​
video_url
string
Kaynak videonun herkese açık URL’si. Güncel herkese açık video-to-video akışlarında ve motion-control modellerinde gereklidir.
​
audio_url
string
audio-to-video destekleyen modeller için herkese açık ses URL’si.
​
task_id
string
Bazı devam, uzatma veya türev akışlarında kullanılan sağlayıcı tarafı görev kimliğidir.
​
extend_at
integer
Bazı video-extension akışlarında kullanılan modele özgü başlangıç ofsetidir.
​
extend_times
string
Bazı video-extension akışlarında kullanılan modele özgü çarpan veya tekrar sayısıdır.
​
duration
integer
Saniye cinsinden video süresi. İzin verilen değerler modele bağlıdır.
​
aspect_ratio
string
En-boy oranı, örneğin 16:9, 9:16 veya 1:1.
​
resolution
string
Çıktı çözünürlüğü, örneğin 720p, 1080p veya 4k. Destek modele bağlıdır.
​
output_audio
boolean
Modele bağlı ses çıkışı anahtarıdır. LemonData’da bu alan gönderilmezse Veo 3 ailesi varsayılan olarak true kabul edilir. CamelCase takma adı outputAudio da uyumluluk için kabul edilir.
​
fps
integer
Saniyedeki kare sayısı (1-120). Yalnızca FPS kontrolü sunan modellerde etkilidir.
​
negative_prompt
string
Üretilen videoda kaçınılması gereken öğeler.
​
seed
integer
Tekrarlanabilir sonuçlar için rastgele seed.
​
cfg_scale
number
Prompt’a bağlılık gücü (0-20). Sadece bu kontrolü sunan modellerde geçerlidir.
​
motion_strength
number
Hareket yoğunluğu (0-1). Sadece bu kontrolü sunan modellerde geçerlidir.
​
start_image
string
start-end-to-video için ilk kare görselinin URL’si veya uyumlu girişidir.
​
end_image
string
start-end-to-video için son kare görselinin URL’si veya uyumlu girişidir.
​
size
string
Bazı OpenAI uyumlu video modellerinde kullanılan modele özgü boyut katmanıdır.
​
watermark
boolean
Bunu herkese açık olarak sunan modeller için filigran anahtarıdır.
​
effect_type
string
Bazı düzenleme veya efekt akışlarında kullanılan modele özgü efekt seçicisidir.
​
user
string
Son kullanıcıya ait benzersiz tanımlayıcıdır.

​
Uyumluluk notları

  • Kanonik herkese açık alanlar snake_case biçimindedir: reference_images, reference_image_type ve output_audio.
  • Uyumluluk amacıyla LemonData ayrıca camelCase takma adları referenceImages, referenceImageType ve outputAudio değerlerini de kabul eder.
  • operation gönderilmezse LemonData bunu girdilerden çıkarır. Yine de üretim için açıkça göndermeniz önerilir.

​
Medya girdileri için en iyi uygulamalar

  • image_url, reference_images, video_url ve audio_url için herkese açık https URL’lerini tercih edin.
  • Mümkünse aynı istekte satır içi base64 ve uzak URL’leri karıştırmayın.
  • İmzalı URL kullanıyorsanız yeniden deneme süresini ve asenkron görev oluşturma sürecini karşılayacak kadar uzun süre geçerli olmasına dikkat edin.

​
Yanıt

​
id
string
Kanonik asenkron görev kimliği.
​
task_id
string
Durum sorgulaması için kullanılacak benzersiz görev tanımlayıcısı.
​
poll_url
string
Bu görev için önerilen durum sorgulama URL’si. Durumu kontrol ederken bu yolu aynen kullanın.
​
status
string
Başlangıç durumu: pending.
​
created
integer
Görevin oluşturulduğu Unix zaman damgası.
​
model
string
Kullanılan model.
​
video_url
string
Sonuç hazırsa doğrudan kullanılabilecek video URL’si.
​
video
object
Mevcutsa url, duration, width ve height içeren tek video nesnesi.
​
videos
array
Üst sağlayıcı birden fazla çıktı döndürdüğünde video dizisi görünebilir.
​
error
string
Görev başarısız olursa dönen hata mesajı ya da yapılandırılmış hata nesnesi.
curl -X POST "https://api.lemondata.cc/v1/videos/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A cat walking through a garden, cinematic lighting",
    "operation": "text-to-video",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "model": "sora-2",
  "created": 1706000000
}

​
Görselden videoya

response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "hailuo-2.3-standard",
        "prompt": "The scene begins from the provided image and adds gentle natural motion.",
        "operation": "image-to-video",
        "image_url": "https://example.com/image.jpg",
        "duration": 6,
        "aspect_ratio": "16:9"
    }
)

​
Referans görselle videoya

Model özel referans görsel koşullandırmasını destekliyorsa operation=reference-to-video kullanın. LemonData’nın herkese açık sözleşmesinde referanslar reference_images üzerinden gönderilir. 
response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "veo3.1",
        "prompt": "Keep the same subject identity, palette, and framing while adding subtle natural motion.",
        "operation": "reference-to-video",
        "reference_images": [
            "https://example.com/ref-a.jpg",
            "https://example.com/ref-b.jpg"
        ],
        "reference_image_type": "asset",
        "duration": 8,
        "resolution": "720p",
        "aspect_ratio": "9:16"
    }
)

​
İlk ve son kare kontrolü

İlk ve son kareyi kontrol etmek için start_image ve end_image kullanın. 
response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "viduq2-pro",
        "prompt": "Smooth transition from day to night",
        "operation": "start-end-to-video",
        "start_image": "https://example.com/day.jpg",
        "end_image": "https://example.com/night.jpg",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9"
    }
)

​
Videodan videoya

Model mevcut bir videoyu birincil giriş olarak kabul ediyorsa operation=video-to-video kullanın. 
response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "topaz-video-upscale",
        "operation": "video-to-video",
        "video_url": "https://example.com/source.mp4",
        "prompt": "Upscale the clip while preserving the original motion.",
        "resolution": "1080p"
    }
)

​
Hareket kontrolü

Model hem özne görseli hem de hareket referans videosu bekliyorsa operation=motion-control kullanın. LemonData herkese açık image_url + video_url biçimini uygun upstream sözleşmesine dönüştürür. 
response = requests.post(
    "https://api.lemondata.cc/v1/videos/generations",
    headers={"Authorization": "Bearer sk-your-api-key"},
    json={
        "model": "kling-3.0-motion-control",
        "operation": "motion-control",
        "prompt": "Keep the subject stable while following the motion reference.",
        "image_url": "https://example.com/subject.png",
        "video_url": "https://example.com/motion.mp4",
        "resolution": "720p"
    }
)

​
Audio-to-video ve video-extension için güncel durum

LemonData’nın herkese açık sözleşmesi modele özgü akışlar için audio-to-video ve video-extension değerlerini kabul eder. Ancak bu doküman derlemesindeki genel olarak etkin herkese açık model listesinde bu iki yeteneği açıkça sunan geniş erişimli bir model bulunmuyor. Bu akışları entegre etmeden önce güncel durumu Models API veya modeller sayfası üzerinden doğrulayın.

​
Güncel herkese açık model envanteri

Bu liste, bu doküman derlemesinde etkin olan herkese açık video modeli envanteriyle hizalanmıştır. En güncel durum için Models API kullanın.

​
OpenAI

ModelHerkese açık işlemler
sora-2Metinden videoya, image-to-video
sora-2-proMetinden videoya, image-to-video
sora-2-pro-storyboardImage-to-video

​
Kuaishou

ModelHerkese açık işlemler
kling-3.0-motion-controlHareket kontrolü
kling-3.0-videoMetinden videoya, image-to-video, start-end-to-video
kling-v2.5-turbo-proMetinden videoya, image-to-video, start-end-to-video
kling-v2.5-turbo-stdMetinden videoya, image-to-video
kling-v2.6-proMetinden videoya, image-to-video, start-end-to-video
kling-v2.6-stdMetinden videoya, image-to-video
kling-v3.0-proMetinden videoya, image-to-video, start-end-to-video
kling-v3.0-stdMetinden videoya, image-to-video, start-end-to-video
kling-video-o1-proMetinden videoya, image-to-video, reference-to-video, start-end-to-video, video-to-video
kling-video-o1-stdMetinden videoya, image-to-video, reference-to-video, start-end-to-video, video-to-video

​
Google

ModelHerkese açık işlemler
veo3Metinden videoya, image-to-video
veo3-fastMetinden videoya, image-to-video
veo3-proMetinden videoya, image-to-video
veo3.1Metinden videoya, image-to-video, reference-to-video, start-end-to-video
veo3.1-fastMetinden videoya, image-to-video, reference-to-video, start-end-to-video
veo3.1-proMetinden videoya, image-to-video, start-end-to-video

​
ByteDance

ModelHerkese açık işlemler
seedance-1.5-proMetinden videoya, image-to-video

​
MiniMax

ModelHerkese açık işlemler
hailuo-2.3-fastImage-to-video
hailuo-2.3-proMetinden videoya, image-to-video
hailuo-2.3-standardMetinden videoya, image-to-video

​
Alibaba

ModelHerkese açık işlemler
wan-2.2-plusMetinden videoya, image-to-video
wan-2.5Metinden videoya, image-to-video
wan-2.6Metinden videoya, image-to-video, reference-to-video

​
Shengshu

ModelHerkese açık işlemler
viduq2Metinden videoya, reference-to-video
viduq2-proImage-to-video, reference-to-video, start-end-to-video
viduq2-pro-fastImage-to-video, start-end-to-video
viduq2-turboImage-to-video, start-end-to-video
viduq3-proMetinden videoya, image-to-video, start-end-to-video
viduq3-turboMetinden videoya, image-to-video, start-end-to-video

​
xAI

ModelHerkese açık işlemler
grok-imagine-image-to-videoImage-to-video
grok-imagine-text-to-videoMetinden videoya
grok-imagine-upscaleVideo-to-video

​
Diğer

ModelHerkese açık işlemler
topaz-video-upscaleVideo-to-video