رابط برنامهنویسی 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 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"
}
}
}'
درباره تفکر بیشتر بدانید:
- تفکر API در Gemini (مقدمه کلی)
- تفکر جما (قابلیتهای خاص جما)
درک تصویر
مدلهای 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
درباره درک تصویر بیشتر بدانید:
- درک تصویر API Gemini (مقدمه کلی)
- درک تصویر Gemma (قابلیتهای خاص Gemma)