رابط برنامه‌نویسی کاربردی (API) توسعه‌دهندگان Gemini در مقابل پلتفرم عامل سازمانی Gemini

گوگل هنگام توسعه راه‌حل‌های هوش مصنوعی مولد با Gemini، دو محصول API ارائه می‌دهد: Gemini Developer API و Gemini Enterprise Agent Platform API .

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

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

ما اخیراً مهاجرت بین این سرویس‌ها را ساده کرده‌ایم. هم API توسعه‌دهندگان Gemini و هم API پلتفرم عامل سازمانی Gemini اکنون از طریق SDK یکپارچه Google GenAI و API تعاملات قابل دسترسی هستند.

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

رابط برنامه‌نویسی کاربردی تعاملات (Interactions API) روش پیشنهادی برای ساخت با مدل‌ها و عامل‌های Gemini است. مثال‌های زیر تولید متن بین رابط برنامه‌نویسی کاربردی توسعه‌دهنده Gemini و پلتفرم عامل سازمانی Gemini را مقایسه می‌کنند.

پایتون

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

رابط برنامه‌نویسی کاربردی (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 

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 Enterprise Agent Platform دسترسی داشته باشید. برای دستورالعمل‌های مربوط به نحوه نصب @google/genai به صفحه کتابخانه‌ها مراجعه کنید.

رابط برنامه‌نویسی کاربردی (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 

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

اگرچه Interactions API برای پروژه‌های جدید توصیه می‌شود، اما generateContent API همچنان پشتیبانی می‌شود.

پایتون

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

رابط برنامه‌نویسی کاربردی (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 

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 Enterprise Agent Platform دسترسی داشته باشید. برای دستورالعمل‌های مربوط به نحوه نصب @google/genai به صفحه کتابخانه‌ها مراجعه کنید.

رابط برنامه‌نویسی کاربردی (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 

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 Enterprise Agent Platform دسترسی داشته باشید. برای دستورالعمل‌های نحوه نصب google.golang.org/genai به صفحه کتابخانه‌ها مراجعه کنید.

رابط برنامه‌نویسی کاربردی (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 

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)

}

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

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

ملاحظات مهاجرت

وقتی مهاجرت می‌کنید:

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

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

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

  2. کلید API مورد نظر برای حذف را پیدا کنید و روی نماد اقدامات کلیک کنید.

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

  4. در پنجره‌ی «حذف اعتبارنامه» ، گزینه‌ی «حذف» را انتخاب کنید.

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

مراحل بعدی