رابط برنامه‌نویسی کاربردی (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 یکپارچه هوش مصنوعی گوگل Gen AI قابل دسترسی هستند.

مقایسه کد

این صفحه مقایسه‌های کد پهلو به پهلو بین رابط برنامه‌نویسی توسعه‌دهنده Gemini و پلتفرم عامل سازمانی Gemini برای تولید متن را ارائه می‌دهد.

پایتون

شما می‌توانید از طریق کتابخانه 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-flash-preview", 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-flash-preview", 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-flash-preview",
    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-flash-preview",
    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-flash-preview", genai.Text("Tell me about New York?"), nil)

}

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

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

// Your GCP project
const project = "your-project"

// A GCP 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-flash-preview", genai.Text("Tell me about New York?"), nil)

}

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

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

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

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

  • برای تأیید اعتبار باید از حساب‌های سرویس Google Cloud استفاده کنید. برای اطلاعات بیشتر به مستندات Gemini Enterprise Agent Platform مراجعه کنید.

  • می‌توانید از پروژه گوگل کلود موجود خود (همان پروژه‌ای که برای تولید کلید API خود استفاده کردید) استفاده کنید یا می‌توانید یک پروژه گوگل کلود جدید ایجاد کنید .

  • مناطق پشتیبانی‌شده ممکن است بین رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Gemini و رابط برنامه‌نویسی کاربردی پلتفرم عامل سازمانی Gemini متفاوت باشند. فهرست مناطق پشتیبانی‌شده برای هوش مصنوعی مولد را در Google Cloud مشاهده کنید.

  • هر مدلی که در Google AI Studio ایجاد کرده‌اید، باید در Gemini Enterprise Agent Platform مجدداً آموزش داده شود.

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

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

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

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

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

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

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

مراحل بعدی