สร้างวิดีโอใน Python

เสร็จสมบูรณ์เมื่อ

Tip

ดูแท็บ ข้อความและรูปภาพ สําหรับรายละเอียดเพิ่มเติม!

ในการสร้างแอปพลิเคชันที่สร้างวิดีโอโดยทางโปรแกรม คุณสามารถใช้ OpenAI Python SDK กับการปรับใช้ Sora 2 ของคุณใน Microsoft Foundry การสร้างวิดีโอเป็นกระบวนการแบบอะซิงโครนัส คุณส่งงาน สํารวจสถานะ และดาวน์โหลดผลลัพธ์เมื่อพร้อม

สร้างวิดีโอ

การสร้างวิดีโอเป็นไปตามรูปแบบสามขั้นตอน: สร้างงาน โพลล์เพื่อให้เสร็จสมบูรณ์ และดาวน์โหลดผลลัพธ์

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")

สร้างวิดีโอจากรูปภาพอ้างอิง

หากต้องการใช้รูปภาพเป็นเฟรมเริ่มต้น ให้ส่งผ่าน input_reference ไปยังพารามิเตอร์ ความละเอียดของภาพต้องตรงกับขนาดวิดีโอเป้าหมาย:

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"),
)

Note

ภาพอ้างอิงที่มีใบหน้ามนุษย์ถูกปฏิเสธในขณะนี้ ใช้ภาพทิวทัศน์ วัตถุ หรือตัวละครเคลื่อนไหวแทน

รีมิกซ์วิดีโอที่มีอยู่

หากต้องการแก้ไขวิดีโอที่มีอยู่โดยที่ยังคงโครงสร้างไว้ ให้ใช้วิธีการรีมิกซ์กับรหัสของวิดีโอต้นฉบับ

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

จัดการสถานะงาน

งานวิดีโอสามารถส่งคืนค่าสถานะเหล่านี้ได้:

สถานะ คำอธิบาย
queued งานกําลังรอดําเนินการ
in_progress กําลังสร้างวิดีโอ
completed วิดีโอพร้อมให้ดาวน์โหลด
failed การสร้างล้มเหลว (ตรวจสอบรายละเอียดข้อผิดพลาด)
cancelled งานถูกยกเลิก

เมื่องานล้มเหลว ให้ตรวจสอบ video.error รายละเอียดเกี่ยวกับสิ่งที่ผิดพลาด

ข้อควรพิจารณาที่สำคัญ

  • ขีดจํากัดอัตรา: คุณสามารถเรียกใช้งานสร้างวิดีโอได้สูงสุด 2 งานพร้อมกัน
  • การหมดอายุของงาน: วิดีโอที่เสร็จสมบูรณ์สามารถดาวน์โหลดได้เป็นเวลา 24 ชั่วโมง
  • ข้อกําหนดด้านความละเอียด: รูปภาพอ้างอิงต้องตรงกับความละเอียดของวิดีโอเป้าหมายทุกประการ
  • การกรองเนื้อหา: ข้อความแจ้งอยู่ภายใต้การกลั่นกรองเนื้อหา เนื้อหาที่เป็นอันตรายจะไม่สร้าง

ในแบบฝึกหัดต่อไปนี้ คุณจะใช้เทคนิคเหล่านี้เพื่อสร้างแอปพลิเคชันการสร้างวิดีโอที่สมบูรณ์