เรียกใช้ Gemma ด้วย Gemini API

Gemini API ให้สิทธิ์เข้าถึง Gemma ที่โฮสต์เป็น API การเขียนโปรแกรมที่คุณใช้ได้ ในการพัฒนาแอปพลิเคชันหรือการสร้างต้นแบบ API นี้เป็นทางเลือกที่สะดวก แทนการตั้งค่าอินสแตนซ์ Gemma ในเครื่องและบริการเว็บของคุณเองเพื่อจัดการ งาน Generative AI

ตัวอย่างต่อไปนี้แสดงวิธีใช้ Gemma กับ Gemini API

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemma-4-31b-it",
    contents="Roses are red...",
)

print(response.text)

Node.js

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY"});

const response = await ai.models.generateContent({
  model: "gemma-4-31b-it",
  contents: "Roses are red...",
});
console.log(response.text);

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemma-4-31b-it:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "Roses are red..."}]
    }]
   }'

รับคีย์ API

คุณเข้าถึง Gemini API ได้ในหลายแพลตฟอร์ม เช่น อุปกรณ์เคลื่อนที่ เว็บ และบริการระบบคลาวด์ รวมถึงใช้ได้กับภาษาโปรแกรมหลายภาษา ดูข้อมูลเพิ่มเติมเกี่ยวกับ แพ็กเกจ SDK ของ Gemini API ได้ที่หน้า การดาวน์โหลด SDK ของ Gemini API ดูข้อมูลเบื้องต้นเกี่ยวกับ Gemini API ได้ที่การเริ่มต้นใช้งาน Gemini API

กำลังคิด

Gemma 4 ใช้ "กระบวนการคิด" ภายในที่เพิ่มประสิทธิภาพการให้เหตุผลแบบหลายขั้นตอน ซึ่งให้ประสิทธิภาพที่เหนือกว่าในโดเมนที่ต้องใช้ตรรกะสูง เช่น การเขียนโค้ดอัลกอริทึมและการพิสูจน์ทางคณิตศาสตร์ขั้นสูง

แม้ว่า Gemma 4 จะรองรับการเปิดหรือปิดฟีเจอร์นี้อย่างเคร่งครัด แต่คุณก็เปิดใช้ฟีเจอร์นี้ ใน API ได้โดยตั้งค่าระดับการคิดเป็น "high"

ตัวอย่างต่อไปนี้แสดงวิธีกระตุ้นกระบวนการคิด

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

response = client.models.generate_content(
    model="gemma-4-31b-it",
    contents="What is the water formula?",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(thinking_level="high")
    ),
)

print(response.text)

Node.js

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

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY"});

const response = await ai.models.generateContent({
  model: "gemma-4-31b-it",
  contents: "What is the water formula?",
  config: {
    thinkingConfig: {
      thinkingLevel: ThinkingLevel.HIGH,
    },
  },
});
console.log(response.text);

REST

curl "https://generativelanguage.googleapis.com/v1beta/models/gemma-4-31b-it:generateContent?key=YOUR_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
  "contents": [{
    "parts":[{"text": "What is the water formula?"}]
    }],
    "generationConfig": {
      "thinkingConfig": {
            "thinkingLevel": "high"
      }
    }
   }'

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Thinking

การทำความเข้าใจรูปภาพ

โมเดล Gemma 4 สามารถประมวลผลรูปภาพได้ ซึ่งช่วยให้นักพัฒนาแอปสามารถใช้กรณีการใช้งานที่ล้ำสมัยมากมาย ซึ่งในอดีตจะต้องใช้โมเดลเฉพาะโดเมน

ตัวอย่างต่อไปนี้แสดงวิธีใช้ข้อมูลรูปภาพของ Gemma กับ Gemini API

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

my_file = client.files.upload(file="path/to/sample.jpg")

response = client.models.generate_content(
    model="gemma-4-31b-it",
    contents=[my_file, "Caption this image."],
)

print(response.text)

Node.js

import {
  GoogleGenAI,
  createUserContent,
  createPartFromUri,
} from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

const myfile = await ai.files.upload({
  file: "path/to/sample.jpg",
  config: { mimeType: "image/jpeg" },
});

const response = await ai.models.generateContent({
  model: "gemma-4-31b-it",
  contents: createUserContent([
    createPartFromUri(myfile.uri, myfile.mimeType),
    "Caption this image.",
  ]),
});
console.log(response.text);
 ```

REST

IMAGE_PATH="cats-and-dogs.jpg"
MIME_TYPE=$(file -b --mime-type "${IMAGE_PATH}")
NUM_BYTES=$(wc -c < "${IMAGE_PATH}")
DISPLAY_NAME=IMAGE

tmp_header_file=upload-header.tmp

# Initial resumable request defining metadata.
# The upload url is in the response headers dump them to a file.
curl "https://generativelanguage.googleapis.com/upload/v1beta/files?key=YOUR_API_KEY" \
  -D upload-header.tmp \
  -H "X-Goog-Upload-Protocol: resumable" \
  -H "X-Goog-Upload-Command: start" \
  -H "X-Goog-Upload-Header-Content-Length: ${NUM_BYTES}" \
  -H "X-Goog-Upload-Header-Content-Type: ${MIME_TYPE}" \
  -H "Content-Type: application/json" \
  -d "{'file': {'display_name': '${DISPLAY_NAME}'}}" 2> /dev/null

upload_url=$(grep -i "x-goog-upload-url: " "${tmp_header_file}" | cut -d" " -f2 | tr -d "\r")
rm "${tmp_header_file}"

# Upload the actual bytes.
curl "${upload_url}" \
  -H "Content-Length: ${NUM_BYTES}" \
  -H "X-Goog-Upload-Offset: 0" \
  -H "X-Goog-Upload-Command: upload, finalize" \
  --data-binary "@${IMAGE_PATH}" 2> /dev/null > file_info.json

file_uri=$(jq -r ".file.uri" file_info.json)
echo file_uri=$file_uri

# Now generate content using that file
curl "https://generativelanguage.googleapis.com/v1beta/models/gemma-4-31b-it:generateContent?key=YOUR_API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[
          {"file_data":{"mime_type": "'"${MIME_TYPE}"'", "file_uri": "'"${file_uri}"'"}},
          {"text": "Caption this image."}]
        }]
      }' 2> /dev/null > response.json

cat response.json
echo

jq -r ".candidates[].content.parts[].text" response.json

ดูข้อมูลเพิ่มเติมเกี่ยวกับความเข้าใจรูปภาพ