Truy vấn video Gemini Omni 1.2 Flash
Truy vấn trạng thái và kết quả tạo video Gemini Omni 1.2 Flash.
Dùng ID tương tác do API tạo trả về để truy vấn trạng thái video, nội dung đã tạo và mức sử dụng.
/v1beta/interactions/{id}Xác thực
bearerAuth Dùng API Key của nền tảng hiện tại.
Vị trí truyền: header
Tham số đường dẫn
ID tương tác do API tạo trả về.
1 <= lengthNội dung phản hồi
application/json
application/json
application/json
application/json
Đọc và lưu video
HTTP 200 chỉ cho biết truy vấn thành công; cần kiểm tra trạng thái tác vụ. Chỉ tiếp tục thăm dò khi là in_progress. Khi tác vụ hoàn tất, thất bại hoặc cần hành động bổ sung, dừng thăm dò nguyên trạng và xử lý theo trạng thái. Trong steps, tìm bước model_output, rồi tìm nội dung type: "video" trong content và giải mã data.
Sau khi tác vụ thành công, dùng Tải video để lưu tệp trực tiếp hoặc tự giải mã Base64 trong phản hồi.
Nếu truy vấn gặp giới hạn tốc độ hoặc lỗi tạm thời, hãy chờ với khoảng lùi tăng dần rồi thử lại.
Ví dụ Python sau đọc phản hồi thành công được lưu trong response.json và giải mã video vào tệp cục bộ. BASE64_ENCODED_VIDEO chỉ là ký hiệu minh họa, không thể dùng để giải mã 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 += 1Phản hồi REST không dùng thuộc tính tiện ích SDK output_video. Để gửi tác vụ mới, dùng Tạo video.