AGTCloud API Docs
مرجع API
توليد الفيديوGemini Omni

الاستعلام عن فيديو Gemini Omni 1.2 Flash

استعلم عن حالة تفاعل فيديو Gemini Omni 1.2 Flash ونتيجته.

استخدم معرّف التفاعل المُعاد من واجهة الإنشاء للاستعلام عن حالة الفيديو والمحتوى المولّد والاستخدام.

GET/v1beta/interactions/{id}

التفويض

bearerAuth
التفويضBearer <token>

استخدم API Key الخاص بالمنصة الحالية.

الموضع: header

معاملات المسار

id*string

معرّف التفاعل الذي أعادته واجهة الإنشاء.

الطول1 <= length

نص الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

قراءة الفيديو وحفظه

HTTP 200 يعني نجاح الاستعلام فقط؛ تحقّق من حالة المهمة. واصل الاستعلام الدوري فقط عند in_progress. عند الاكتمال أو الفشل أو الحاجة إلى إجراء إضافي، أوقف الاستعلام دون تغيير وتعامل مع الحالة. ابحث في steps عن خطوة model_output، ثم عن محتوى 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 الرسمي للاستعلام عن التفاعلاطّلع على تعريف بروتوكول المصدر وأحدث تغييرات الحقول.