AGTCloud API Docs
Hướng dẫnAPI ReferenceTích hợp và tài nguyênCập nhật và hỗ trợ
Tạo videoGemini Omni

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.

GET/v1beta/interactions/{id}

Xác thực

bearerAuth
Xác thựcBearer <token>

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*string

ID tương tác do API tạo trả về.

Độ dài1 <= length

Nộ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 += 1

Phả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.

Tài liệu chính thức Google Gemini Omni về truy vấn tương tácXem định nghĩa giao thức nguồn và các thay đổi trường mới nhất.