Gemini SDK

Google Gen AI SDK cung cấp máy khách Python và TypeScript. Dùng cấu hình HTTP tùy chỉnh của SDK để gửi yêu cầu Generate Content đến điểm vào tương thích Gemini của AGTCloud.

Trang này chỉ trình bày generateContent và streamGenerateContent. Tham khảo AGTCloud API Reference để biết khả năng sử dụng tệp, bộ nhớ đệm, Live API, quản lý mô hình và tài nguyên nền tảng Google khác.

Chuẩn bị

Trước khi bắt đầu, hãy đảm bảo bạn đã:

• Tạo AGTCloud API Key trên trang API Keys;
• Sao chép ID mô hình đầy đủ hỗ trợ Gemini Generate Content từ danh mục mô hình;
• Chuẩn bị môi trường máy chủ được hỗ trợ. @google/genai 2.x hiện yêu cầu Node.js 20+; kiểm tra lại yêu cầu môi trường trước khi nâng cấp phiên bản chính.

Trang này dùng MODEL_ID và your-api-key làm giá trị giữ chỗ. Không lưu API Key thật trong trình duyệt, gói cài đặt máy khách hoặc kho mã công khai.

Cài đặt SDK

python -m pip install google-genai

Dùng phiên bản ổn định hiện tại của google-genai hoặc @google/genai. Hướng dẫn yêu cầu SDK hỗ trợ Base URL, phiên bản API và Header tùy chỉnh; nếu hàm khởi tạo không nhận http_options / httpOptions bên dưới, nâng cấp SDK trước.

Cấu hình API Key

Lưu API Key trong biến môi trường phía máy chủ:

export AGTCLOUD_API_KEY="your-api-key"

Điểm vào tương thích Gemini của AGTCloud dùng Bearer API Key. Cấu hình máy khách dưới đây giữ cấu trúc yêu cầu Google Gen AI SDK và thêm rõ Header Authorization: Bearer ....

Google Gen AI SDK vẫn yêu cầu khởi tạo api_key / apiKey, nên SDK cũng gửi x-goog-api-key. Header này do SDK tạo, không thay thế Bearer Header mà AGTCloud dùng.

Tạo máy khách và gửi yêu cầu

Dùng API Origin hiển thị trên trang này làm Base URL, không thêm /v1, /v1beta hoặc đường dẫn nghiệp vụ đầy đủ. SDK ghép /v1beta/models/{model}:generateContent theo api_version / apiVersion và phương thức mô hình.

import os

from google import genai
from google.genai import types

api_key = os.environ["AGTCLOUD_API_KEY"]

client = genai.Client(
    api_key=api_key,
    http_options=types.HttpOptions(
        base_url="https://api.agtcloud.cn",
        api_version="v1beta",
        headers={"Authorization": f"Bearer {api_key}"},
    ),
)

response = client.models.generate_content(
    model="MODEL_ID",
    contents="Hãy giới thiệu bản thân bằng ba câu.",
)

print(response.text)

Đầu ra dạng luồng

import os

from google import genai
from google.genai import types

api_key = os.environ["AGTCLOUD_API_KEY"]

client = genai.Client(
    api_key=api_key,
    http_options=types.HttpOptions(
        base_url="https://api.agtcloud.cn",
        api_version="v1beta",
        headers={"Authorization": f"Bearer {api_key}"},
    ),
)

for chunk in client.models.generate_content_stream(
    model="MODEL_ID",
    contents="Hãy giải thích ngắn gọn tìm kiếm vectơ là gì.",
):
    if chunk.text:
        print(chunk.text, end="", flush=True)

Phương thức luồng liên tục trả về các phần phản hồi Generate Content. Trong môi trường sản xuất, xử lý mất kết nối, hết thời gian chờ, khối văn bản trống và yêu cầu không kết thúc bình thường.

Câu hỏi thường gặp

Bước tiếp theo

• Xem Gemini Generate Content API Reference để biết contents, parts, cấu hình sinh nội dung và cấu trúc phản hồi đầy đủ.
• Xem Gemini Stream Generate Content API Reference để biết điểm cuối luồng và sự kiện phản hồi.
• Dự án SDK chính thức hiện có có thể theo Chuyển đổi SDK chính thức để thay từng cấu hình và kiểm thử hồi quy.
• Khi yêu cầu thất bại, xem Xác thực và API Key và Lỗi và khắc phục sự cố.