Agent Flatform của Google và 300$ miễn phí gọi full API Gemini

Hệ sinh thái trí tuệ nhân tạo của Google ngày càng phát triển mạnh mẽ với bộ công cụ Agent Flatform. Bài viết này sẽ mang lại cho bạn cái nhìn tổng quan về kiến trúc kết nối và cung cấp bộ tài liệu tích hợp đầy đủ phía dưới bài viết.

Việc kết nối trực tiếp với Agent Flatform qua API Key giúp hệ thống của bạn hoạt động độc lập, mượt mà và tối ưu hóa chi phí vận hành. Cho dù dự án của bạn được xây dựng trên môi trường Node.js (JavaScript), PHP (WordPress, Laravel) hay Python, bộ API này đều hỗ trợ các cơ chế giao tiếp chuẩn hóa như gửi nhận đồng bộ, stream dữ liệu thời gian thực (SSE) hoặc xử lý bất đồng bộ (Long Running Operation – LRO) cho các tác vụ nặng.

Bốn tính năng cốt lõi của Agent Flatform API

Bộ API này cung cấp khả năng xử lý toàn diện các định dạng nội dung thông qua bốn dịch vụ chính:

• Sinh văn bản (Gemini): Hỗ trợ hội thoại thông minh, tóm tắt nội dung và sinh bài viết tự động. Lập trình viên có thể tùy chọn nhận dữ liệu dạng đồng bộ hoặc dạng stream thời gian thực để tạo hiệu ứng phản hồi gõ chữ mượt mà.
• Tạo hình ảnh (Imagen): Cho phép tạo hình ảnh nghệ thuật từ mô tả văn bản hoặc sinh ảnh mới dựa trên một ảnh tham chiếu có sẵn (Image-to-Image). Dữ liệu ảnh trả về trực tiếp dưới dạng Base64 Data URI tiện lợi.
• Tạo video (Veo): Hỗ trợ sinh video ngắn chân thực. Do tác vụ dựng video tốn thời gian, API hoạt động theo cơ chế LRO (Long Running Operation): bạn gửi yêu cầu khởi tạo tác vụ, sau đó thực hiện kiểm tra trạng thái tiến trình (polling) định kỳ cho đến khi hoàn thành.
• Tạo giọng đọc (TTS): Chuyển đổi văn bản thành âm thanh giọng nói tự nhiên với các giọng mẫu phòng thu chất lượng cao (như Puck, Kore, Fenrir…).

Tổng quan về kiến trúc kết nối và các endpoint của hệ thống

Các yêu cầu giao tiếp từ ứng dụng của bạn đến máy chủ Google sẽ được xác thực thông qua API Key và định tuyến qua các endpoint chính:

Endpoint tạo văn bản, hình ảnh và giọng nói (Đồng bộ):

POST https://aiplatform.googleapis.com/v1/publishers/google/models/{MODEL}:generateContent?key={API_KEY}

Endpoint khởi tạo tiến trình tạo video (Bất đồng bộ LRO):

POST https://us-central1-aiplatform.googleapis.com/v1/projects/{PROJECT_NUMBER}/locations/us-central1/publishers/google/models/{MODEL}:predictLongRunning?key={API_KEY}

Endpoint kiểm tra tiến độ tạo video (Polling LRO):

POST https://us-central1-aiplatform.googleapis.com/v1/projects/{PROJECT_NUMBER}/locations/us-central1/publishers/google/models/{MODEL}:fetchPredictOperation?key={API_KEY}

Tải về tài liệu hướng dẫn và mã nguồn tích hợp (SKILL.md)

Google hiện đang áp dụng chương trình tặng gói credit khuyến mãi dùng thử trị giá 7.900.000 VNĐ (tương đương $300 USD) để các nhà phát triển trải nghiệm toàn bộ sức mạnh của các mô hình AI thế hệ mới. Tuy nhiên, rất nhiều lập trình viên đã gặp phải một tình huống tréo ngoe: dù tài khoản vẫn còn nguyên gói khuyến mãi gần 8 triệu đồng, nhưng khi gọi trực tiếp API Gemini hoặc sử dụng thông qua Google AI Studio, hóa đơn thanh toán vẫn tự động được tạo và trừ tiền thẳng vào thẻ tín dụng (Visa/Mastercard) đã liên kết.

Nguyên nhân là do Google áp dụng cơ chế thanh toán tách biệt giữa nền tảng phát triển nhanh Google AI Studio và hệ thống đám mây doanh nghiệp Google Cloud Platform (GCP). Để gói ngân sách khuyến mãi $300 được cấn trừ tự động và hoàn toàn miễn phí, bạn bắt buộc phải thực hiện các cuộc gọi API thông qua cổng Agent Flatform của Google. Khi định tuyến các yêu cầu HTTP qua hệ sinh thái này, hệ thống thanh toán của Google Cloud sẽ nhận dạng và trừ chi phí trực tiếp vào hạn mức khuyến mãi dùng thử thay vì ghi nợ vào thẻ của bạn.

Để giúp bạn nhanh chóng triển khai các tính năng trên vào dự án thực tế mà không cần tự viết lại các hàm kết nối phức tạp, tôi đã biên soạn một tài liệu hướng dẫn kỹ năng tích hợp chi tiết (dưới dạng file `SKILL.md`).

Nội dung của file hướng dẫn bao gồm:

• Mã nguồn JavaScript / Node.js đầy đủ sử dụng Fetch API chuẩn để gọi tạo văn bản, tạo ảnh (có xử lý Base64 Data URI), tạo giọng nói TTS và điều phối tiến trình tạo video LRO.
• Mã nguồn PHP sử dụng thư viện cURL chuẩn (dành cho mọi dự án PHP thuần, Laravel) và mã nguồn tối ưu hóa riêng cho nền tảng WordPress sử dụng `wp_remote_post`.
• Mã nguồn Python sử dụng thư viện `requests` tối giản cùng cơ chế bắt lỗi và kiểm tra HTTP Status Code chặt chẽ.

Bạn có thể tải trực tiếp file cấu hình hướng dẫn tích hợp này về máy bằng liên kết bên dưới và làm theo hướng dẫn để bắt đầu nâng cấp ứng dụng của mình ngay hôm nay!