مقایسه Gemini Developer API و پلاتفرم Gemini

هنگام توسعه راه‌حل‌های هوش مصنوعی زایا با Gemini،‏ Google دو محصول API ارائه می‌دهد: Gemini Developer API و Gemini platform API.

‫Gemini Developer API سریع‌ترین مسیر را برای ساختن، تولید کردن، و مقیاس‌بندی برنامه‌های با بهره‌گیری از Gemini فراهم می‌کند. اکثر توسعه‌دهندگان باید از «میانای برنامه‌سازی کاربردی توسعه‌دهندگان Gemini» استفاده کنند، مگراینکه نیاز به کنترل‌های سازمانی خاصی باشد.

پلاتفرم Gemini اکوسیستم جامعی از ویژگی‌ها و سرویس‌های آماده برای شرکت‌ها برای ساختن و استقرار دادن برنامه‌های هوش مصنوعی زایا با پشتیبانی Google Cloud ارائه می‌دهد.

اخیراً انتقال بین این سرویس‌ها را ساده‌تر کرده‌ایم. اکنون هم Gemini Developer API و هم Gemini platform API ازطریق Google GenAI SDK یکپارچه و Interactions API دردسترس هستند.

مقایسه کد: Interactions API (توصیه‌شده)

میانای برنامه‌سازی کاربردی تعاملات روش توصیه‌شده برای ساختن با مدل‌ها و نمایندگان Gemini است. مثال‌های زیر تولید نوشتار را بین Gemini Developer API و پلاتفرم Gemini مقایسه می‌کند.

Python

می‌توانید ازطریق کتابخانه google-genai (>= 2.3.0) به Gemini Developer API و خدمات پلاتفرم Gemini دسترسی پیدا کنید. برای دستورالعمل‌های نصب google-genai، به صفحه کتابخانه‌ها مراجعه کنید.

Gemini Developer API

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words",
)
print(interaction.output_text)

Gemini platform API

from google import genai

client = genai.Client(
    enterprise=True, project="your-project-id", location="global"
)

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words",
)
print(interaction.output_text)

جاوا اسکریپت و تایپ‌اسکریپت

می‌توانید ازطریق کتابخانه @google/genai (>= 2.3.0) به Gemini Developer API و خدمات پلاتفرم Gemini دسترسی داشته باشید. برای دستورالعمل‌های نصب @google/genai، صفحه کتابخانه‌ها را ببینید.

Gemini Developer API

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

const ai = new GoogleGenAI({});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

Gemini platform API

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

const ai = new GoogleGenAI({
  enterprise: true,
  project: "your_project",
  location: "global",
});

const interaction = await ai.interactions.create({
  model: "gemini-3.8-flash",
  input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);

مقایسه کد: generateContent API

اگرچه «میانای برنامه‌سازی کاربردی تعامل‌ها» برای پروژه‌های جدید توصیه می‌شود، generateContent API همچنان پشتیبانی می‌شود.

Python

ازطریق کتابخانه google-genai می‌توانید به Gemini Developer API و سرویس‌های پلاتفرم Gemini دسترسی داشته باشید. برای دریافت دستورالعمل‌های مربوط به نحوه نصب google-genai، صفحه کتابخانه‌ها را ببینید.

Gemini Developer API

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)

Gemini platform API

from google import genai

client = genai.Client(
    vertexai=True, project='your-project-id', location='us-central1'
)

response = client.models.generate_content(
    model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)

جاوا اسکریپت و تایپ‌اسکریپت

می‌توانید ازطریق کتابخانه @google/genai به هر دو سرویس Gemini Developer API و پلاتفرم Gemini دسترسی داشته باشید. برای دریافت دستورالعمل‌های مربوط به نحوه نصب @google/genai، به صفحه کتابخانه‌ها مراجعه کنید.

Gemini Developer API

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

const ai = new GoogleGenAI({});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Gemini platform API

import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({
  vertexai: true,
  project: 'your_project',
  location: 'your_location',
});

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.8-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

رفتن

می‌توانید ازطریق کتابخانه google.golang.org/genai به هر دو سرویس Gemini Developer API و پلاتفرم Gemini دسترسی داشته باشید. برای دریافت دستورالعمل‌های مربوط به نحوه نصب google.golang.org/genai، به صفحه کتابخانه‌ها مراجعه کنید.

Gemini Developer API

import (
  "context"
  "encoding/json"
  "fmt"
  "log"
  "google.golang.org/genai"
)

// Your Google API key
const apiKey = "your-api-key"

func main() {
  ctx := context.Background()
  client, err := genai.NewClient(ctx, nil)
  if err != nil {
      log.Fatal(err)
  }

  // Call the GenerateContent method.
  result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)

}

Gemini platform API

import (
  "context"
  "encoding/json"
  "fmt"
  "log"
  "google.golang.org/genai"
)

// Your Google Cloud project
const project = "your-project"

// A Google Cloud location like "us-central1"
const location = "some-gcp-location"

func main() {
  ctx := context.Background()
  client, err := genai.NewClient(ctx, &genai.ClientConfig
  {
        Project:  project,
      Location: location,
      Backend:  genai.BackendVertexAI,
  })

  // Call the GenerateContent method.
  result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)

}

سایر موارد استفاده و پلاتفرم‌ها

برای پلاتفرم‌ها و موارد استفاده دیگر، به راهنماهای ویژه مورد استفاده در اسناد Gemini Developer API و اسناد پلاتفرم Gemini مراجعه کنید.

ملاحظات انتقال

وقتی انتقال می‌دهید:

اگر دیگر نیازی به استفاده از کلید Gemini API برای Gemini Developer API ندارید، روال‌های مطلوب امنیتی را دنبال کنید و آن را حذف کنید.

برای حذف کلید میانای API:

  1. صفحه اطلاعات اعتباری Google Cloud API را باز کنید.

  2. کلید API موردنظر برای حذف را پیدا کنید و روی نماد کنش‌ها کلیک کنید.

  3. حذف کلید API را انتخاب کنید.

  4. در مدال حذف اطلاعات اعتباری، حذف را انتخاب کنید.

    حذف کلید API چند دقیقه طول می‌کشد تا منتشر شود. پس‌از تکمیل انتشار، هرگونه ترافیک که از کلید API حذف‌شده استفاده کند رد می‌شود.

مراحل بعدی