Gửi tài khoản mật khẩu để lấy session cookie.

Parameters (JSON)

Response Headers

Set-Cookie: session=ey...; Path=/; HttpOnly; SameSite=Lax

Ví dụ cURL với API Key

curl -X POST "http://127.0.0.1:5000/api/generate_video" \
  -H "X-API-Key: veo_live_a1b2c3d4e5f67890..." \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "chú mèo nhảy múa trong mưa, 4k",
    "aspect_ratio": "VIDEO_ASPECT_RATIO_LANDSCAPE"
  }'

Ví dụ Code Python với API Key

import requests

API_KEY = "veo_live_a1b2c3d4e5f67890..."
headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json"
}

resp = requests.post("http://127.0.0.1:5000/api/generate_video", json={
    "prompt": "cô gái mặc áo dài truyền thống Việt Nam",
    "aspect_ratio": "VIDEO_ASPECT_RATIO_PORTRAIT"
}, headers=headers).json()

print(resp)

Tham Số Khởi Tạo Request

Trong request POST /api/generate_video hoặc POST /api/generate, bổ sung 2 trường:

Cấu Trúc Payload Server Gửi Trả Về Webhook URL

{
  "success": true,
  "videos": [
    {
      "url": "http://127.0.0.1:5000/outputs/video_abc123.mp4",
      "media_id": "video_abc123",
      "index": 1,
      "name": "operations/eb4a58ba-..."
    }
  ],
  "total_generated": 1,
  "prompt": "chú mèo nhảy múa trong mưa, 4k",
  "account_id": "user_AccountA_101"
}

Ví dụ Code Server Bên Thứ Ba (Node.js / Express) Kiểm Tra Chữ Ký Webhook Signature

const express = require('express');
const crypto = require('crypto');
const app = express();

app.use(express.json());

const WEBHOOK_SECRET = "my_webhook_secret_key";

app.post('/api/callback', (req, res) => {
    const signature = req.headers['x-webhook-signature'];
    
    if (WEBHOOK_SECRET && signature) {
        const expectedSig = crypto
            .createHmac('sha256', WEBHOOK_SECRET)
            .update(JSON.stringify(req.body))
            .digest('hex');
            
        if (signature !== expectedSig) {
            console.error("❌ Webhook Signature Invalid!");
            return res.status(401).send("Invalid signature");
        }
    }

    console.log("🎉 Nhận kết quả Video thành công từ Veo Server:", req.body);
    // Xử lý lưu database hoặc gửi thông báo cho client của bạn ở đây...
    
    res.status(200).send("OK");
});

app.listen(3000, () => console.log('Webhook Listener running on port 3000'));

Gửi prompt tạo ảnh. API trả về URL ảnh khi hoàn thành (đồng bộ). Hỗ trợ ảnh tham chiếu bằng media_ids.

Parameters

Response

{
  "success": true,
  "images": [
    {
      "index": 1,
      "url": "https://flow-content.google/image/b42c6ab5-...",
      "media_id": "b42c6ab5-982f-41bd-8c84-b35bfe2a4a5f"  // UUID
    }
  ],
  "total_generated": 1,
  "account_id": "Maimaicodn",    // Tài khoản đã tạo
  "project_id": "0ffa648a-...",  // Project ID
  "acc_type": "both"             // Loại tài khoản
}
// → Lưu media_id + account_id → dùng cho /api/generate_video

Upload ảnh lên Google qua multipart/form-data. Trả về media_id dùng làm ảnh tham chiếu hoặc khung hình đầu cho Video (I2V).

Request (Form-Data)

cURL

curl -X POST http://127.0.0.1:5000/api/upload_image \
  -F "file=@/path/to/image.jpg"

Response

{
  "success": true,
  "media_id": "projects/.../media/123456789"
}

Tạo video qua Google Veo. Text-to-Video (T2V): chỉ cần prompt. Image-to-Video (I2V / R2V): truyền ref_image_urls (URL ảnh) hoặc start_media_path (file ảnh local).

Parameters

Ví dụ Python — Tạo ảnh bằng Nano Model rồi tạo video bằng Tài khoản Ultra

import requests

BASE = "http://YOUR_SERVER:5000"

# Bước 1: Tạo ảnh bằng bất kỳ Model Nano nào (Nano Pro, Nano 2, Nano 2 Lite)
img_res = requests.post(f"{BASE}/api/generate", json={
    "prompt": "một chú mèo dễ thương",
    "model": "GEM_PIX_2"  # GEM_PIX_2 (Nano Pro), NARWHAL (Nano 2) hoặc HARBOR_SEAL (Nano 2 Lite)
}, timeout=120).json()

img_url = img_res["images"][0]["url"]

# Bước 2: Tạo video bằng Tài khoản Ultra (Server tự động re-upload ngầm sang Ultra Account)
vid_res = requests.post(f"{BASE}/api/generate_video", json={
    "prompt": "chú mèo di chuyển linh hoạt, camera xoay quanh",
    "model": "veo_3_1_r2v_lite_low_priority",
    "ref_image_urls": [img_url]  # Truyền URL ảnh → Server tự động re-upload sang Ultra Account!
}, timeout=600).json()

print("Link Video Ultra:", vid_res["videos"][0]["url"])

Hồi sinh link media bằng cách lấy redirect URL mới từ Google.

Parameters

Trả về trạng thái hoạt động, số tài khoản, hàng chờ.

Lấy danh sách tất cả tài khoản đã đăng ký và trạng thái hoạt động.

Request Body

{
  "id": "email@gmail.com",
  "cookies": [
    {"name":"__Secure-1PSID","value":"...","domain":".google.com"},
    {"name":"__Secure-1PSIDTS","value":"..."}
  ]
}

Lấy danh sách kịch bản đang chờ chạy, đang chạy hoặc tạm dừng.

Thêm một hoặc nhiều tác vụ kịch bản vào cuối hàng chờ để xử lý tuần tự.

Parameters

Thay đổi trạng thái hoạt động của hàng chờ (bắt đầu chạy, tạm dừng, xóa hàng chờ, v.v.).

Parameters

Sử dụng PUT để cập nhật tác vụ tại vị trí index hoặc DELETE để xóa tác vụ đó khỏi hàng chờ.

Xem danh sách kết quả các tác vụ đã hoàn thành hoặc thất bại.

Trả về thông số tổng quan hệ thống: Số lượng tạo ảnh/video, tỉ lệ thành công, tài khoản active và lượng tài nguyên đã sử dụng.

Trả về danh sách tất cả các bảng trong CSDL SQLite và số lượng dòng hiện có.

Tải trực tiếp file CSDL database.db về máy tính để sao lưu hoặc kiểm tra offline.

Dọn dẹp các ô nhớ trống và giải phóng dung lượng đĩa cho file database.db.

Đọc hoặc thay đổi trạng thái disable_auth_mode (Cho phép gọi API không cần Cookie/Xác thực).

POST Request Body

{ "disable_auth_mode": true }

Lấy logs realtime để hiển thị trạng thái trên ứng dụng của bạn.