สอบถามวิดีโอ Gemini Omni 1.2 Flash
สอบถามสถานะและผลลัพธ์ของการโต้ตอบวิดีโอ Gemini Omni 1.2 Flash
ใช้ ID การโต้ตอบจาก API สร้างเพื่อสอบถามสถานะวิดีโอ เนื้อหาที่สร้าง และปริมาณการใช้งาน
/v1beta/interactions/{id}การยืนยันตัวตน
bearerAuth ใช้ API Key ของแพลตฟอร์มปัจจุบัน
ตำแหน่ง: header
พารามิเตอร์เส้นทาง
ID การโต้ตอบที่ API สร้างส่งกลับมา
1 <= lengthเนื้อหาการตอบกลับ
application/json
application/json
application/json
application/json
application/json
application/json
อ่านและบันทึกวิดีโอ
HTTP 200 หมายถึงสอบถามสำเร็จเท่านั้น ต้องตรวจสถานะงานด้วย สอบถามซ้ำเฉพาะเมื่อเป็น in_progress หากงานเสร็จ ล้มเหลว หรือต้องทำสิ่งเพิ่มเติม ให้หยุดสอบถามแบบเดิมและจัดการตามสถานะ ค้นหาขั้นตอน model_output ใน steps แล้วหา type: "video" ใน content เพื่อถอดรหัส data
เมื่องานสำเร็จ ใช้ ดาวน์โหลดวิดีโอ เพื่อบันทึกไฟล์โดยตรง หรือถอดรหัส Base64 จากคำตอบด้วยตนเอง
หากการสอบถามติดขีดจำกัดอัตราหรือเกิดข้อผิดพลาดชั่วคราว ให้รอแบบเพิ่มช่วงเวลาแล้วลองใหม่
ตัวอย่าง Python ต่อไปนี้อ่านคำตอบสำเร็จจาก response.json และถอดรหัสวิดีโอเป็นไฟล์ในเครื่อง BASE64_ENCODED_VIDEO เป็นเพียงเครื่องหมายประกอบคำอธิบาย ไม่สามารถใช้ถอดรหัสเป็นวิดีโอได้
import base64
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8"))
video_index = 0
for step in response.get("steps", []):
if step.get("type") != "model_output":
continue
for item in step.get("content", []):
if item.get("type") == "video" and item.get("data"):
Path(f"video-{video_index}.mp4").write_bytes(
base64.b64decode(item["data"], validate=True)
)
video_index += 1คำตอบ REST ไม่ใช้พร็อพเพอร์ตีอำนวยความสะดวก output_video ของ SDK หากต้องการส่งงานใหม่ ให้ใช้ สร้างวิดีโอ