AGTCloud API Docs
เอกสารอ้างอิง API
การสร้างวิดีโอGemini Omni

สอบถามวิดีโอ Gemini Omni 1.2 Flash

สอบถามสถานะและผลลัพธ์ของการโต้ตอบวิดีโอ Gemini Omni 1.2 Flash

ใช้ ID การโต้ตอบจาก API สร้างเพื่อสอบถามสถานะวิดีโอ เนื้อหาที่สร้าง และปริมาณการใช้งาน

GET/v1beta/interactions/{id}
การยืนยันตัวตนBearer <token>

ใช้ API Key ของแพลตฟอร์มปัจจุบัน

ตำแหน่ง: header

พารามิเตอร์เส้นทาง

id*string

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 หากต้องการส่งงานใหม่ ให้ใช้ สร้างวิดีโอ

เอกสารทางการ Google Gemini Omni สำหรับสอบถามการโต้ตอบดูข้อกำหนดโปรโตคอลต้นทางและการเปลี่ยนแปลงฟิลด์ล่าสุด