Python'da video oluşturma

Tamamlandı

Tip

Daha fazla ayrıntı için Metin ve resimler sekmesine bakın!

Program aracılığıyla video oluşturan uygulamalar oluşturmak için Microsoft Foundry'de Sora 2 dağıtımınızla OpenAI Python SDK'sını kullanabilirsiniz. Video oluşturma işlemi asenkron bir süreçtir; bir iş gönderir, durumunu kontrol eder ve hazır olduğunda sonucu indirirsiniz.

Video oluşturma

Video oluşturma üç adımlı bir süreç izler: işi oluşturun, tamamlanmasını bekleyin ve sonucu indirin.

import time

# Create the video generation job
video = client.videos.create(
    model="sora-2",
    prompt="A robot walks through a rainy city street at dusk, neon signs reflecting in puddles",
    size="1280x720",
    seconds="4",
)

print(f"Video creation started. ID: {video.id}")

# Poll for completion
while video.status not in ["completed", "failed", "cancelled"]:
    print(f"Status: {video.status}. Waiting...")
    time.sleep(20)
    video = client.videos.retrieve(video.id)

# Download when complete
if video.status == "completed":
    content = client.videos.download_content(video.id, variant="video")
    content.write_to_file("output.mp4")
    print("Video saved to output.mp4")

Başvuru görüntüsünden video oluşturma

Bir görüntüyü başlangıç çerçevesi olarak kullanmak için parametresine input_reference geçirin. Görüntü çözünürlüğü hedef video boyutuyla eşleşmelidir:

video = client.videos.create(
    model="sora-2",
    prompt="The camera slowly pans across the landscape as clouds drift overhead",
    size="1280x720",
    seconds="4",
    input_reference=open("landscape.png", "rb"),
)

Uyarı

İnsan yüzleri içeren başvuru görüntüleri şu anda reddediliyor. Bunun yerine manzara, nesne veya animasyonlu karakter görüntülerini kullanın.

Mevcut bir videoyu yeniden düzenle

Mevcut bir videoyu yapısını korurken değiştirmek için, orijinal videonun kimliğiyle remix yöntemini kullanın:

video = client.videos.remix(
    video_id="video_abc123",
    prompt="Change the color palette to warm sunset tones",
)

İş durumlarını yönetme

Video görevleri şu durum değerlerini döndürebilir:

Statü	Açıklama
queued	İş işlenmeyi bekliyor
in_progress	Video oluşturuluyor
completed	Video indirmeye hazır
failed	Oluşturma başarısız oldu (hata ayrıntılarını denetleyin)
cancelled	İş iptal edildi

bir iş başarısız olduğunda, neyin yanlış gittiğiyle ilgili ayrıntıları denetleyin video.error .

Dikkat edilmesi gereken temel konular

• Hız sınırları: Aynı anda en fazla iki video oluşturma işi çalıştırabilirsiniz
• İş süresinin dolması: Tamamlanan videolar 24 saat boyunca indirilebilir
• Çözünürlük gereksinimleri: Başvuru görüntüleri hedef video çözünürlüğüyle tam olarak eşleşmelidir
• İçerik filtreleme: İstemler içerik denetimine tabidir; zararlı içerik oluşturulmayacak

Aşağıdaki alıştırmada, eksiksiz bir video oluşturma uygulaması oluşturmak için bu teknikleri uygulayacaksınız.