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 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 = "Long text content to be referenced repeatedly...".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 = "Long text content to be referenced repeatedly..." * 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)