Gemma را با API Gemini اجرا کنید

رابط برنامه‌نویسی Gemini دسترسی میزبانی‌شده به Gemma را به عنوان یک API برنامه‌نویسی فراهم می‌کند که می‌توانید در توسعه برنامه یا نمونه‌سازی اولیه از آن استفاده کنید. این API جایگزین مناسبی برای راه‌اندازی نمونه محلی Gemma و سرویس وب خودتان برای انجام وظایف هوش مصنوعی مولد است.

مثال زیر نحوه استفاده از Gemma با API Gemini را نشان می‌دهد:

پایتون

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)

نود جی اس

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);

استراحت

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

شما می‌توانید به API Gemini در پلتفرم‌های مختلفی مانند موبایل، وب و سرویس‌های ابری و با زبان‌های برنامه‌نویسی متعدد دسترسی داشته باشید. برای اطلاعات بیشتر در مورد بسته‌های SDK API Gemini، به صفحه دانلودهای SDK API Gemini مراجعه کنید. برای آشنایی کلی با API Gemini، به راهنمای سریع API Gemini مراجعه کنید.

تفکر

جما ۴ از یک «فرآیند تفکر» داخلی استفاده می‌کند که استدلال چند مرحله‌ای آن را بهینه می‌کند و عملکرد برتر را در حوزه‌های منطقاً پیچیده مانند کدگذاری الگوریتمی و اثبات‌های ریاضی پیشرفته ارائه می‌دهد.

اگرچه Gemma 4 اکیداً از فعال یا غیرفعال کردن این ویژگی پشتیبانی می‌کند، اما شما می‌توانید با تنظیم سطح تفکر روی "high" ، آن را در API فعال کنید.

مثال زیر نحوه فعال کردن فرآیند تفکر را نشان می‌دهد:

پایتون

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)

نود جی اس

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);

استراحت

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"
      }
    }
   }'

درباره تفکر بیشتر بدانید:

درک تصویر

مدل‌های Gemma 4 می‌توانند تصاویر را پردازش کنند و بسیاری از موارد استفاده توسعه‌دهندگان پیشرو را که از نظر تاریخی به مدل‌های خاص دامنه نیاز داشتند، امکان‌پذیر سازند.

مثال زیر نحوه استفاده از ورودی‌های تصویر Gemma را با API Gemini نشان می‌دهد:

پایتون

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)

نود جی اس

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);
 ```

استراحت

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

درباره درک تصویر بیشتر بدانید: