Gemini 原生 SDK 接入

npm install @google/genai
# 要求 >= 2.0.0；推薦安裝 latest

pip install -U google-genai
# 要求 >= 2.0.0

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  apiKey: "sk-***", // 替換為你在 AIHubMix 生成的 API Key
  httpOptions: {
    baseUrl: "https://aihubmix.com/gemini",
  },
});

from google import genai

client = genai.Client(
    api_key="sk-***",  # 替換為你在 AIHubMix 生成的 API Key
    http_options={"base_url": "https://aihubmix.com/gemini"},
)

const interaction = await ai.interactions.create({
  model: "gemini-3.5-flash",
  input: "Explain quantum computing in one sentence",
});

console.log(interaction.output_text);
console.log(interaction.usage);
// { total_tokens, total_input_tokens, total_output_tokens, ... }

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain quantum computing in one sentence",
)

print(interaction.output_text)

import fs from "node:fs";

const interaction = await ai.interactions.create({
  model: "gemini-3.1-flash-image",
  input: "A translucent banana-shaped glass lamp on a white desk, soft studio lighting.",
  response_modalities: ["text", "image"],
  response_format: { type: "image", aspect_ratio: "1:1", image_size: "1K" },
});

// 方式 1：output_image 便捷屬性（取最後一張生成圖像）
if (interaction.output_image?.data) {
  fs.writeFileSync("output.png", Buffer.from(interaction.output_image.data, "base64"));
}

// 方式 2：遍歷 steps，適用於多步驟混合輸出
for (const step of interaction.steps ?? []) {
  for (const block of step.content ?? []) {
    if (block.type === "image" && block.data) {
      fs.writeFileSync("output.png", Buffer.from(block.data, "base64"));
    }
  }
}

import base64

interaction = client.interactions.create(
    model="gemini-3.1-flash-image",
    input="A translucent banana-shaped glass lamp on a white desk, soft studio lighting.",
    response_format={
        "type": "image",
        "aspect_ratio": "1:1",
        "image_size": "1K",
    },
)

# output_image 便捷屬性
if interaction.output_image:
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(interaction.output_image.data))

const task = await ai.interactions.create({
  model: "gemini-3.5-flash",
  input: "Explain the water cycle in three sentences.",
  background: true,
});

console.log(task.id, task.status); // iact1_xxx in_progress

let result;
for (let i = 0; i < 60; i++) {
  await new Promise((r) => setTimeout(r, 3000));
  try {
    const current = await ai.interactions.get(task.id);
    if (["completed", "failed", "cancelled"].includes(current.status)) {
      result = current;
      break;
    }
  } catch (err) {
    continue; // 結果未就緒，繼續輪詢
  }
}

console.log(result.output_text);
console.log(result.usage);

import time
from google.genai import errors

task = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain the water cycle in three sentences.",
    background=True,
)

print(task.id, task.status)  # iact1_xxx in_progress

result = None
for _ in range(60):
    time.sleep(3)
    try:
        current = client.interactions.get(task.id)
    except errors.APIError:
        continue  # 結果未就緒，繼續輪詢
    if current.status in ("completed", "failed", "cancelled"):
        result = current
        break

print(result.output_text)
print(result.usage)

const response = await ai.models.embedContent({
  model: "gemini-embedding-2-preview",
  contents: "What is the meaning of life?",
  config: {
    outputDimensionality: 768, // 可選：指定輸出維度（128–3072），預設 3072
  },
});

console.log("dimensions:", response.embeddings[0].values.length); // 768

from google.genai import types

result = client.models.embed_content(
    model="gemini-embedding-2-preview",
    contents="What is the meaning of life?",
    config=types.EmbedContentConfig(
        output_dimensionality=768,  # 可選：指定輸出維度（128–3072），預設 3072
    ),
)

print(f"dimensions: {len(result.embeddings[0].values)}")  # 768

const longDocument = "需要反覆引用的長文字內容...".repeat(500);

const cache = await ai.caches.create({
  model: "gemini-3.5-flash",
  config: {
    contents: longDocument,
    ttl: "300s",
  },
});

console.log("CachedContent name:", cache.name);
// 格式：cachedContents/xxx

long_document = "需要反覆引用的長文字內容..." * 500

cache = client.caches.create(
    model="gemini-3.5-flash",
    config={
        "contents": long_document,
        "ttl": "300s",
    },
)

print(f"CachedContent name: {cache.name}")

const response = await ai.models.generateContent({
  model: "gemini-3.5-flash",
  contents: "Please summarize the core points of the above document",
  config: { cachedContent: cache.name },
});

console.log(response.text);
console.log("cached tokens:", response.usageMetadata?.cachedContentTokenCount);

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Please summarize the core points of the above document",
    config={"cached_content": cache.name},
)

print(response.text)
print(f"cached tokens: {response.usage_metadata.cached_content_token_count}")

// 查詢 CachedContent 中繼資料
const info = await ai.caches.get({ name: cache.name });
console.log("model:", info.model, "expireTime:", info.expireTime);

// 刪除快取
await ai.caches.delete({ name: cache.name });

# 查詢 CachedContent 中繼資料
info = client.caches.get(name=cache.name)
print(f"model: {info.model}  expire_time: {info.expire_time}")

# 刪除快取
client.caches.delete(name=cache.name)