Video üretimi

Seedance, Kling, Omni, Wan, Grok, Veo, Vidu, PixVerse ve MiniMax ile bir istemden, ilk kareden (isteğe bağlı olarak son kareden de) veya referans görsellerden, videolar ve ses video oluşturun. Videoların hazırlanması birkaç dakika sürer; bu yüzden önce işlemi başlatır, sonra durumunu kontrol edersiniz.

Başlatın, durumu sorgulayın, indirin

import os, time, requests
API = "https://api.zurelay.com/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ZURELAY_API_KEY']}"}
# 1. Start the video
response = requests.post(f"{API}/videos", headers=HEADERS, json={
    "model": "seedance-2.0",
    "prompt": "A paper boat drifting down a rain-soaked street at night, neon reflections, slow dolly shot",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
})
response.raise_for_status()  # a 4xx says what to fix
job = response.json()
# 2. Poll until it's done (usually 2 to 6 minutes)
while job["status"] in ("queued", "in_progress"):
    time.sleep(10)
    job = requests.get(f"{API}/videos/{job['id']}", headers=HEADERS).json()
if job["status"] == "failed":
    raise SystemExit(job["error"]["message"])
# 3. Download the MP4
video = requests.get(f"{API}/videos/{job['id']}/content", headers=HEADERS)
open("boat.mp4", "wb").write(video.content)

Tüm video modelleri aynı şekilde çalışır: model değerini değiştirmeniz yeterlidir, istek aynı kalır. Her modelin güçlü yanları model rehberlerinde açıklanır: Seedance, Kling, Wan, Grok Imagine, Omni Flash, MiniMax H3, Veo, Vidu ve PixVerse.

Parametreler

Görsellerden başlama

İlk ve son kare

Sabit bir görseli canlandırın: video tam olarak first_frame ile açılır. last_frame eklerseniz o görselle biter; böylece çekimin hem başlangıcını hem sonunu kontrol edersiniz. MiniMax starts ise referans görsellerden oluşturur.

{
  "model": "seedance-2.0",
  "first_frame": "https://example.com/storefront-day.jpg",
  "last_frame": "https://example.com/storefront-night.jpg",
  "prompt": "Time passes from afternoon to night; lights come on inside the shop.",
  "seconds": 6,
  "resolution": "720p"
}

Referans görseller

En fazla 10 görsel (Seedance up to 9, Kling up to 10, Omni up to 10, Wan up to 10, Grok up to 3, MiniMax up to 9; Veo, Vidu ve PixVerse take none) verin ve istemde bunlara sırayla atıfta bulunun (@Image1, @Image2…): görsellerdeki kişiler, ürünler ve yerler videoda görünür.

{
  "model": "seedance-2.5",
  "reference_images": [
    "https://example.com/chef.jpg",
    "https://example.com/kitchen.jpg",
    "https://example.com/dish.jpg"
  ],
  "prompt": "The chef from @Image1 plates the dish from @Image3 in the kitchen from @Image2, close-up, warm light.",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "9:16"
}

Referans videolar ve sesler

Bir kişinin görünümünü ve hareketlerini, bir kamera hareketini veya sahneyi örnek almak için video; ses, melodi veya efekt için ses kaydı verin. Görsellerde olduğu gibi istemde bunlara sırayla atıfta bulunun: @Video1, @Audio1. Referans görsellerle birlikte kullanılabilirler, ancak ilk kareyle kullanılamazlar.

{
  "model": "seedance-2.5",
  "reference_images": ["https://example.com/singer.jpg"],
  "reference_videos": ["https://example.com/dance-moves.mp4"],
  "reference_audio": ["https://example.com/chorus.mp3"],
  "prompt": "The singer from @Image1 performs the dance from @Video1 on a rooftop at dusk, singing to @Audio1.",
  "seconds": 8,
  "resolution": "720p"
}

Model, referans videonun her saniyesini okur; bu yüzden bu süre de video saniye ücretinin bir kısmı üzerinden ücretlendirilir: 10 s referans kullanan 5 s bir video için 5 saniyelik video ve 10 saniyelik referans ücreti ödenir. Referans ses için ek ücret alınmaz. Her video nesnesi, ücretlendirilen referans saniyelerini gösterir (reference_seconds).

Videoyu düzenleme ve uzatma

Bir referans videoyu değiştirmek (kişi veya nesne değiştirmek, bir şey eklemek ya da kaldırmak, müziği değiştirmek) için reference_mode değerini edit olarak, ileriye veya geriye doğru uzatmak içinse extend olarak ayarlayın. Ne yapılacağını istemde belirtin: “@Video1 içindeki arabayı @Image1 içindekiyle değiştir”, “Dansçı sahneden ayrılırken @Video1 videosunu devam ettir”.

• Düzenleme, videonun en boy oranını ve süresini korur; bu yüzden aspect_ratio ve seconds belirtmeyin. Ücret, en uzun referans videonun süresine göre hesaplanır; bu video 4 ile 30 saniye arasında olmalıdır.
• Uzatma, videonun en boy oranını korur; seconds yeni videonun süresini belirler.
• reference_mode belirtilmezse model isteme göre karar verir; seconds veya aspect_ratio ayarlıyken düzenleme olarak yorumlanan bir istem başarısız olabilir (başarısız videolar ücretsizdir).

Görsel kuralları

• Herkese açık bir https bağlantısı veya veri URL’si olarak PNG, JPEG ya da WebP, en fazla 10 MB.
• Her kenar 300 ile 6000 piksel arasında olmalı; genişliğin yüksekliğe veya yüksekliğin genişliğe oranı 5:2 değerini aşmamalıdır. Bu sınırların dışındaki veri URL’leri, nedenini açıklayan bir mesajla baştan reddedilir. Bağlantılar video başlatılırken okunur: kullanılabilir bir görsel içermeyen bağlantılar, videonun invalid_image ile başarısız olmasına neden olur ve ücret alınmaz.
• Tek istekte ya kareler ya da referanslar kullanılabilir, ikisi birden kullanılamaz.
• İstekler JSON biçimindedir: görseller multipart yükleme olarak değil, bağlantı veya veri URL’si olarak gönderilir.

Video nesnesi

{
  "id": "video_abc123",
  "object": "video",
  "model": "seedance-2.0",
  "status": "completed",
  "progress": 100,
  "created_at": 1790870400,
  "completed_at": 1790870562,
  "expires_at": 1793462400,
  "seconds": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "size": "1280x720",
  "generate_audio": true,
  "url": "https://...signed link...",
  "url_expires_at": 1790956962,
  "cost": 1.035,
  "error": null
}

Diğer endpoint'ler

Video ücretlendirmesi

Bir videonun ücreti, çözünürlüğe göre saniye başına fiyatı ile süresinin çarpımıdır; sessiz olduğunda saniye başına Kling ve PixVerse cost daha az; referans videoların süresi, bu fiyatın bir kısmı üzerinden eklenir. Video oluşturmayı başlattığınızda bu tutar bakiyenizden ayrılır; video tamamlandığında tahsil edilir, başarısız olursa serbest bırakılır. Başarısız videolar ücretsizdir.