Gemini API, Google'ın son teknoloji video oluşturma modeli Veo 2'ye erişim sağlar. Veo, kullanıcı istemlerini ve resimlerini yüksek kaliteli video öğelerine dönüştüren yeni nesil yapay zeka uygulamaları oluşturmanıza yardımcı olmak için tasarlanmıştır.
Bu kılavuz, Gemini API'yi kullanarak Veo'yu kullanmaya başlamanıza yardımcı olacaktır.
Veo hakkında
Veo, Google'ın bugüne kadarki en yetenekli video oluşturma modelidir. Çeşitli sinema ve görsel stillerinde videolar oluşturur. Bu videolarda, istemdeki nüansları yakalayarak karmaşık ayrıntıları kareler arasında tutarlı bir şekilde gösterir.
Daha fazla bilgi edinmek ve örnek çıkışı görmek için Google DeepMind Veo'ya genel bakış başlıklı makaleyi inceleyin.
Özellikler
Modlar |
|
İstek gecikmesi |
|
Değişken uzunluk oluşturma | 5-8 saniye |
Çözüm | 720p |
Kare hızı | 24 fps |
En boy oranı |
|
Giriş dilleri (metinden videoya) | İngilizce |
Veo tarafından oluşturulan videolara, yapay zeka tarafından üretilen içeriğe filigran eklemek ve içeriği tanımlamak için kullandığımız SynthID aracıyla filigran eklenir. Ayrıca, gizlilik, telif hakkı ve önyargı risklerini azaltmaya yardımcı olan güvenlik filtrelerinden ve ezberleme kontrolü işlemlerinden geçirilir.
Başlamadan önce
Gemini API'yi çağırmadan önce seçtiğiniz SDK'nın yüklü olduğundan ve Gemini API anahtarının yapılandırılmış ve kullanıma hazır olduğundan emin olun.
Veo'yu Google Gen AI SDK'larıyla kullanmak için aşağıdaki sürümlerden birini yüklediğinizden emin olun:
- Python 1.10.0 veya sonraki sürümler
- TypeScript ve JavaScript v0.8.0 veya sonraki sürümler
- Go 1.0.0 veya sonraki sürümler
Video oluştur
Bu bölümde, metin istemlerini ve resimleri kullanarak video oluşturmayla ilgili kod örnekleri verilmiştir.
Metinden oluşturma
Veo ile video oluşturmak için aşağıdaki kodu kullanabilirsiniz:
Python
import time
from google import genai
from google.genai import types
client = genai.Client() # read API key from GOOGLE_API_KEY
operation = client.models.generate_videos(
model="veo-2.0-generate-001",
prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
config=types.GenerateVideosConfig(
person_generation="dont_allow", # "dont_allow" or "allow_adult"
aspect_ratio="16:9", # "16:9" or "9:16"
),
)
while not operation.done:
time.sleep(20)
operation = client.operations.get(operation)
for n, generated_video in enumerate(operation.response.generated_videos):
client.files.download(file=generated_video.video)
generated_video.video.save(f"video{n}.mp4") # save the video
REST
# Use curl to send a POST request to the predictLongRunning endpoint
# The request body includes the prompt for video generation
curl "${BASE_URL}/models/veo-2.0-generate-001:predictLongRunning?key=${GOOGLE_API_KEY}" \
-H "Content-Type: application/json" \
-X "POST" \
-d '{
"instances": [{
"prompt": "Panning wide shot of a calico kitten sleeping in the sunshine"
}
],
"parameters": {
"aspectRatio": "16:9",
"personGeneration": "dont_allow",
}
}' | tee result.json | jq .name | sed 's/"//g' > op_name
Bu kodun çalışması yaklaşık 2-3 dakika sürer ancak kaynaklar kısıtlıysa daha uzun sürebilir. İşlem tamamlandığında şuna benzer bir video görürsünüz:
Video yerine bir hata mesajı görüyorsanız kaynaklar sınırlı olduğu için isteğiniz tamamlanamamıştır. Bu durumda kodu tekrar çalıştırın.
Oluşturulan videolar 2 gün boyunca sunucuda depolanır ve ardından kaldırılır. Oluşturulan videonuzun yerel bir kopyasını kaydetmek istiyorsanız video oluşturulduktan sonraki 2 gün içinde result()
ve save()
komutlarını çalıştırmanız gerekir.
Resimlerden oluşturma
Resim kullanarak da video oluşturabilirsiniz. Aşağıdaki kod, Imagen'i kullanarak bir resim oluşturur ve ardından oluşturulan resmi, oluşturulan videonun başlangıç karesi olarak kullanır.
Öncelikle Imagen'i kullanarak bir resim oluşturun:
Python
prompt="Panning wide shot of a calico kitten sleeping in the sunshine",
imagen = client.models.generate_images(
model="imagen-3.0-generate-002",
prompt=prompt,
config=types.GenerateImagesConfig(
aspect_ratio="16:9",
number_of_images=1
)
)
imagen.generated_images[0].image
Ardından, elde edilen resmi ilk kare olarak kullanarak bir video oluşturun:
Python
operation = client.models.generate_videos(
model="veo-2.0-generate-001",
prompt=prompt,
image = imagen.generated_images[0].image,
config=types.GenerateVideosConfig(
# person_generation only accepts "dont_allow" for image-to-video
aspect_ratio="16:9", # "16:9" or "9:16"
number_of_videos=2
),
)
# Wait for videos to generate
while not operation.done:
time.sleep(20)
operation = client.operations.get(operation)
for n, video in enumerate(operation.response.generated_videos):
fname = f'with_image_input{n}.mp4'
print(fname)
client.files.download(file=video.video)
video.video.save(fname)
Veo model parametreleri
(Adlandırma kuralları, programlama diline göre değişir.)
prompt
: Videonun metin istemi. Mevcut olduğundaimage
parametresi isteğe bağlıdır.image
: Videonun ilk karesi olarak kullanılacak resim. Mevcut olduğundaprompt
parametresi isteğe bağlıdır.negativePrompt
: Modelin oluşturmasını engellemek istediğiniz her şeyi tanımlayan metin dizesiaspectRatio
: Oluşturulan videonun en-boy oranını değiştirir."16:9"
ve"9:16"
değerleri desteklenir. Varsayılan değer"16:9"
'tir.personGeneration
: Modelin, insanların yer aldığı videolar oluşturmasına izin verin. Aşağıdaki değerler desteklenir:- Metinden video oluşturma:
"dont_allow"
: Resimlerde insan veya yüzlere izin verilmez."allow_adult"
: Çocuklar yerine yetişkinlerin yer aldığı videolar oluşturun.
- Resimden video oluşturma:
"dont_allow"
: Resimden video oluşturma işlemi için varsayılan ve tek değerdir.
- Metinden video oluşturma:
numberOfVideos
: İstenilen çıkış videoları (1
veya2
).durationSeconds
: Her çıkış videosunun süresi (5
ile8
arasında saniye cinsinden).enhance_prompt
: İstem yeniden yazıcıyı etkinleştirin veya devre dışı bırakın. Varsayılan olarak etkindir.
Deneyebileceğiniz şeyler
Veo'dan en iyi şekilde yararlanmak için istemlerinize videoya özgü terminolojileri dahil edin. Veo aşağıdakilerle ilgili çok çeşitli terimleri anlar:
- Kademe kompozisyonu: Kadrajı ve kadrajdaki öznelerin sayısını belirtin (ör. "tek plan," "çift plan," "omuz üzerinden plan").
- Kamera konumlandırma ve hareketi: "Göz hizasında", "yüksek açı", "kurt gözü", "dolly çekim", "yakın çekim", "yatay kaydırma" ve "takip çekimi" gibi terimleri kullanarak kameranın konumunu ve hareketini kontrol edin.
- Odak ve lens efektleri: Belirli görsel efektler elde etmek için "yüzeysel odak", "derin odak", "yumuşak odak", "makro lens" ve "geniş açılı lens" gibi terimleri kullanın.
- Genel stil ve konu: "Bilim kurgu ","romantik komedi","aksiyon filmi" veya "animasyon " gibi stilleri belirterek Veo'nun reklam öğesi yönünü yönlendirin. İstediğiniz konuları ve arka planları da tanımlayabilirsiniz (ör. "şehir manzarası", "doğa", "araçlar" veya "hayvanlar").
Veo istem rehberi
Veo rehberinin bu bölümünde, Veo'yu kullanarak oluşturabileceğiniz video örnekleri yer alır ve farklı sonuçlar elde etmek için istemleri nasıl değiştireceğiniz gösterilir.
Güvenlik filtreleri
Veo, oluşturulan videoların ve yüklenen fotoğrafların rahatsız edici içerikler içermemesini sağlamak için Gemini'de güvenlik filtreleri uygular. Hükümler ve yönergelerimizi ihlal eden istemler engellenir.
İstem yazmayla ilgili temel bilgiler
İyi istemler açıklayıcı ve net olmalıdır. Oluşturulan videonun istediğinize mümkün olduğunca yakın olmasını sağlamak için temel fikrinizi belirlemeye başlayın ve ardından anahtar kelimeler ve değiştiriciler ekleyerek fikrinizi hassaslaştırın.
İsteminize aşağıdaki öğeler eklenmelidir:
- Öğe: Videonuzda olmasını istediğiniz nesne, kişi, hayvan veya manzara.
- Bağlam: Öznenin yerleştirildiği arka plan veya bağlam.
- İşlem: Öznenin yaptığı işlem (ör. yürüyüş, koşma veya başını çevirme).
- Stil: Genel veya çok spesifik olabilir. Korku filmi, kara film gibi belirli film stili anahtar kelimelerini veya çizgi film gibi animasyonlu stilleri kullanabilirsiniz.
- Kamera hareketi: [İsteğe bağlı] Kameranın yaptığı hareketler (ör. havadan görünüm, göz hizasında, yukarıdan çekim veya aşağıdan çekim).
- Kompozisyon: [İsteğe bağlı] Çekimin kadraja alma şekli (ör. geniş çekim, yakın çekim veya ultra yakın çekim).
- Ambiance: [İsteğe bağlı] Rengin ve ışığın sahneye katkısı (ör. mavi tonlar, gece veya sıcak tonlar).
İstem yazmayla ilgili daha fazla ipucu
Aşağıdaki ipuçları, videolarınızı oluşturacak istemler yazmanıza yardımcı olur:
- Açıklayıcı bir dil kullanın: Veo'ya net bir resim çizmek için sıfatlar ve edatlar kullanın.
- Bağlam bilgisi sağlayın: Gerekirse modelinizin ne istediğinizi anlamasına yardımcı olmak için arka plan bilgileri ekleyin.
- Belirli sanatsal stillere referans verin: Belirli bir estetik anlayışınız varsa belirli sanatsal stillere veya sanat hareketlerine referans verin.
- İstem mühendisliği araçlarından yararlanın: İstemlerinizi hassaslaştırmanıza ve en iyi sonuçları elde etmenize yardımcı olacak istem mühendisliği araçlarını veya kaynaklarını keşfedin. Daha fazla bilgi için İstem tasarımına giriş başlıklı makaleyi inceleyin.
- Kişisel ve grup resimlerinizdeki yüz ayrıntılarını iyileştirin: İstemde portre kelimesini kullanarak yüz ayrıntılarını fotoğrafın odak noktası olarak belirtin.
Örnek istemler ve çıkış
Bu bölümde, açıklayıcı ayrıntıların her videonun sonucunu nasıl iyileştirebileceğini vurgulayan çeşitli istemler sunulmaktadır.
Buz Saçakları
Bu videoda, istem yazmayla ilgili temel bilgiler kapsamındaki öğeleri isteminizde nasıl kullanabileceğiniz gösterilmektedir.
İstem | Oluşturulan çıkış |
---|---|
Soğuk mavi tonların (ambiyans) hakim olduğu donmuş bir kaya duvarında (bağlam) eriyen buz sarkıtlarının (özne) yakın çekimi (kompozisyon), su damlalarının (hareket) yakın plan ayrıntılarını koruyacak şekilde yakınlaştırılmış (kamera hareketi). |
![]() |
Telefonda konuşan adam
Bu videolarda, Veo'nun sonucu sizin istediğiniz şekilde hassaslaştırması için isteminizi giderek daha ayrıntılı bilgilerle nasıl düzeltebileceğiniz gösterilmektedir.
İstem | Oluşturulan çıkış | Analiz |
---|---|---|
Kamera, yeşil trençkotlu çaresiz bir adamın yakın çekimini gösterir. Yeşil neon ışıklı, döner kadranlı bir duvar telefonundan arama yapıyor. Film sahnesine benziyor. |
![]() |
Bu, istem temel alınarak oluşturulan ilk videodur. |
Yıpranmış yeşil trençkotu giyen çaresiz bir adamın, yeşil neon ışığın ürkütücü parıltısı altında, kaba tuğla duvara monte edilmiş bir çevirmeli telefonu çevirdiği sinematik bir yakın plan çekimi. Kamera yakınlaştırarak çenesindeki gerginliği ve aramayı yapmak için uğraşırken yüzüne yansıyan çaresizliği gösterir. Az alan derinliği, kaşları çatık adamın ve siyah kadranlı telefonun üzerine odaklanır. Arka plan ise neon renklerin ve belirsiz gölgelerin oluşturduğu bir denize dönüşür. Bu da aciliyet ve yalnızlık hissi verir. |
![]() |
Daha ayrıntılı bir istem, daha odaklanmış ve daha zengin bir ortamla sonuçlanan bir video oluşturur. |
Yeşil trençkotlu çaresiz bir adamın, ürkütücü yeşil neon ışığa boğulmuş bir duvara yaslanarak eski bir çevirmeli telefon kullandığı pürüzsüz hareketli bir video. Kamera orta mesafeden başlar ve aceleyle telefon numarasını çeviren adamın yüzünü yavaşça yaklaştırarak endişeli ifadesini ve alnındaki teri gösterir. Odak, adamın ellerine ve parmaklarınadır. Adam, bağlantı kurmaya çalışırken parmaklarıyla kadran üzerinde beceriksizce geziniyor. Yeşil neon ışık, duvara uzun gölgeler düşürerek gergin atmosferi artırıyor. Sahne, adamın yalnızlığını ve çaresizliğini vurgulamak için çekilmiştir. Neonun canlı parıltısı ile adamın kararlılığı arasındaki keskin kontrastı öne çıkarır. |
![]() |
Daha fazla ayrıntı eklemek, özneye gerçekçi bir ifade verir ve yoğun ve canlı bir sahne oluşturur. |
Kar leoparı
Bu örnekte, Veo'nun basit bir istem için oluşturabileceği çıkış gösterilmektedir.
İstem | Oluşturulan çıkış |
---|---|
3D çizgi film stilinde oluşturulmuş, kar leoparı benzeri kürkü olan sevimli bir yaratık kış ormanında yürüyor. |
![]() |
Koşan kar leoparı
Bu istem daha ayrıntılı olup videonuzda istediğiniz şeye daha yakın olabilecek oluşturulan çıkışı gösterir.
İstem | Oluşturulan çıkış |
---|---|
Eğlenceli bir çizgi film stilinde kısa bir 3D animasyonlu sahne oluşturun. Kar leoparı benzeri kürkü, etkileyici büyük gözleri ve sevimli, yuvarlak hatlarıyla ilginç bir kış ormanında mutlu bir şekilde zıplayan sevimli bir yaratık. Karla kaplı yuvarlak ağaçlar, yavaşça düşen kar taneleri ve dallardan süzülen sıcak güneş ışığı bu sahnede yer almalıdır. Yaratığın sıçrayan hareketleri ve geniş gülümsemesi, saf bir sevinç hissi vermelidir. Canlı, neşeli renkler ve eğlenceli animasyonlarla neşeli ve iç açıcı bir ton kullanın. |
![]() |
Yazma öğelerine göre örnekler
Bu örneklerde, istemlerinizi her temel öğeye göre nasıl hassaslaştıracağınız gösterilmektedir.
Konu
Bu örnekte, konu açıklamasının nasıl belirtileceği gösterilmektedir.
Konu açıklaması | İstem | Oluşturulan çıkış |
---|---|---|
Açıklamada bir konu veya birden fazla konu ve işlem bulunabilir. Buradaki konumuz "beyaz beton apartman binası"dır. | Akıcı organik şekillere sahip, yemyeşil bitki örtüsü ve fütürist unsurlarla sorunsuz bir şekilde uyum sağlayan beyaz beton bir apartmanın mimari görseli |
![]() |
Bağlam
Bu örnekte, bağlamı nasıl belirteceğiniz gösterilmektedir.
Bağlam | İstem | Oluşturulan çıkış |
---|---|---|
Öznenin yerleştirileceği arka plan veya bağlam çok önemlidir. Öznenizi kalabalık bir sokağa veya uzaya gibi çeşitli arka planlara yerleştirmeyi deneyin. | Arka planda ay ve bazı yıldızlar olan, uzayda yüzen bir uydu. |
![]() |
İşlem
Bu örnekte, işlemi nasıl belirteceğiniz gösterilmektedir.
İşlem | İstem | Oluşturulan çıkış |
---|---|---|
Öznenin yaptığı hareketler (ör. yürüme, koşma veya başını çevirme). | Gün batımında ufukta rahat ve memnun bir şekilde sahil boyunca yürüyen bir kadının geniş açıdan çekilmiş fotoğrafı. |
![]() |
Stil
Bu örnekte stilin nasıl belirtileceği gösterilmektedir.
Stil | İstem | Oluşturulan çıkış |
---|---|---|
Oluşturma kalitesini iyileştirmek ve oluşturulan resmin istediğiniz stile daha yakın olmasını sağlamak için anahtar kelimeler ekleyebilirsiniz. Örneğin, alan derinliği az, film karesi, minimalist, gerçeküstü, vintage, fütürist veya çift pozlama gibi anahtar kelimeler ekleyebilirsiniz. | Film noir stili, sokakta yürüyen bir erkek ve kadın, gizem, sinematik, siyah beyaz. |
![]() |
Kamera hareketi
Bu örnekte, kamera hareketinin nasıl belirtileceği gösterilmektedir.
Kamera hareketi | İstem | Oluşturulan çıkış |
---|---|---|
Kamera hareketi seçenekleri arasında birinci şahıs kamerası, havadan görünüm, takip eden drone görünümü veya takip kamerası görünümü bulunur. | Gece Kanada'da yağmur yağarken eski bir arabadan çekilmiş, sinematik bir sürüş kamerası görüntüsü. |
![]() |
Beste
Bu örnekte, kompozisyonun nasıl belirtileceği gösterilmektedir.
Kompozisyon | İstem | Oluşturulan çıkış |
---|---|---|
Çekimin çerçevesi (geniş açı, yakın çekim, düşük açı). | Şehrin yansıdığı bir gözün çok yakın çekimi. |
![]() |
Sörf tahtasıyla plajda yürüyen bir sörfçünün geniş açı çekiminden oluşan, sinematize bir video oluşturun. |
![]() |
Ortam
Bu örnekte, ambiyansın nasıl belirtileceği gösterilmektedir.
Ambiance | İstem | Oluşturulan çıkış |
---|---|---|
Renk paletleri, fotoğrafta önemli bir rol oynar. Ruh halini etkiler ve amaçlanan duyguları aktarır. "Sessiz turuncu sıcak tonlar", "doğal ışık", "güneş doğuşu" veya "gün batımı" gibi terimleri deneyin. Örneğin, sıcak ve altın tonlarında bir palet, fotoğrafa romantik ve atmosferik bir hava katabilir. | Parkta güneş ışığı altında sevimli bir golden retriever yavrusu tutan kızın yakın plan görüntüsü. |
![]() |
Yağmurda otobüse binen hüzünlü bir kadının sinematik yakın çekimi, soğuk mavi tonlar, hüzünlü hava. |
![]() |
Video oluşturmak için referans görselleri kullanma
Veo'nun resimlerden video oluşturma özelliğini kullanarak resimlere hayat verebilirsiniz. Mevcut öğeleri kullanabilir veya yeni bir öğe oluşturmak için Imagen'i deneyebilirsiniz.
İstem | Oluşturulan çıkış |
---|---|
Çikolatalı bar tutan tavşan. |
![]() |
Bunny kaçar. |
![]() |
Olumsuz istemler
Negatif istemler, videoda istemediğiniz öğeleri belirtmenize yardımcı olacak güçlü bir araç olabilir. "Negatif istem" ifadesinden sonra, modelin oluşturmasını engellemek istediğiniz içeriği açıklayın. Şu ipuçlarını uygulayın:
❌ Talimat verici dil veya hayır ya da yapma gibi kelimeler kullanmayın. Örneğin, "Duvar yok" veya "duvarları gösterme".
❌ Görmek istemediğiniz içerikleri açıklamayın. Örneğin, "duvar, çerçeve". Bu, videoda duvar veya çerçeve istemediğiniz anlamına gelir.
İstem | Oluşturulan çıkış |
---|---|
Rüzgarda şiddetle sallanan yaprakları olan, tek başına duran büyük bir meşe ağacının kısa ve stilize bir animasyonunu oluşturun. Ağaç, dinamik ve akıcı dalları olan, biraz abartılı ve tuhaf bir şekle sahip olmalıdır. Yapraklar, rüzgarda dönen ve dans eden çeşitli sonbahar renklerini göstermelidir. Animasyonda sıcak ve davetkar bir renk paleti kullanılmalıdır. |
![]() |
Rüzgarda şiddetle sallanan yaprakları olan, tek başına duran büyük bir meşe ağacının kısa ve stilize bir animasyonunu oluşturun. Ağaç, dinamik ve akıcı dalları olan, biraz abartılı ve tuhaf bir şekle sahip olmalıdır. Yapraklar, rüzgarda dönen ve dans eden çeşitli sonbahar renklerini göstermelidir. Animasyonda sıcak ve davetkar bir renk paleti kullanılmalıdır.
Negatif istemle: kentsel arka plan, insan yapımı yapılar, karanlık, fırtınalı veya tehditkar bir atmosfer. |
![]() |
En boy oranları
Gemini Veo video oluşturma, aşağıdaki iki en boy oranını destekler:
En boy oranı | Açıklama |
---|---|
Geniş ekran veya 16:9 | Televizyonlar, monitörler ve cep telefonu ekranları için en yaygın en boy oranıdır (yatay). Doğa manzaralarında olduğu gibi arka planı daha fazla yakalamak istediğinizde bu seçeneği kullanın. |
Dikey veya 9:16 | Döndürülmüş geniş ekran. Bu en boy oranı, YouTube Shorts gibi kısa video uygulamaları tarafından yaygınlaştırılmıştır. Bu ayarı, dikey yönde güçlü olan portreler veya uzun nesneler (ör. binalar, ağaçlar, şelaleler) için kullanın. |
Geniş ekran
Bu istem, 16:9 geniş ekran en boy oranına örnektir.
İstem | Oluşturulan çıkış |
---|---|
1970'lerde Palm Springs'te kırmızı bir cabrio araba süren bir adamın sıcak güneş ışığı ve uzun gölgeler eşliğinde takip eden bir drone görüntüsü içeren bir video oluşturun. |
![]() |
Dikey
Bu istem, 9:16 dikey en boy oranına örnektir.
İstem | Oluşturulan çıkış |
---|---|
Hawaii'deki yemyeşil yağmur ormanlarında bulunan görkemli bir şelalenin sunduğu pürüzsüz hareketleri öne çıkaran bir video oluşturun. Sakinlik hissi vermek için gerçekçi su akışına, ayrıntılı bitki örtüsüne ve doğal ışığa odaklanın. Akan suları, puslu atmosferi ve yoğun ağaç örtüsünün arasından süzülen güneş ışığını yakalayın. Şelaleyi ve çevresini göstermek için kamerayı yumuşak ve sinematik hareketlerle kullanın. İzleyiciyi Hawaii yağmur ormanlarının huzurlu güzelliğine götürecek huzurlu ve gerçekçi bir ton hedefleyin. |
![]() |
Sırada ne var?
- Veo Colab ile yapay zeka videoları oluşturma konusunda daha fazla deneyim kazanın.