‫Gemini 4 Argon متاح الآن. جرِّب هذه الميزة.

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

التوافق مع OpenAI

يمكن الوصول إلى نماذج Gemini باستخدام مكتبات OpenAI (Python وTypeScript / Javascript) بالإضافة إلى REST API، من خلال تعديل ثلاثة أسطر من الرموز البرمجية واستخدام مفتاح Gemini API. إذا لم تكن تستخدم مكتبات OpenAI، ننصحك بطلب Gemini API مباشرةً.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[
        {   "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Explain to me how AI works"
        }
    ]
)

print(response.choices[0].message)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

const response = await openai.chat.completions.create({
    model: "gemini-3.8-flash",
    messages: [
        {   role: "system",
            content: "You are a helpful assistant." 
        },
        {
            role: "user",
            content: "Explain to me how AI works",
        },
    ],
});

console.log(response.choices[0].message);

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "messages": [
      {
        "role": "user",
        "content": "Explain to me how AI works"
      }
    ]
  }'

ما الذي تغيّر؟ ثلاثة أسطر فقط!

api_key="GEMINI_API_KEY": استبدِل "GEMINI_API_KEY" بمفتاح واجهة برمجة التطبيقات الفعلي في Gemini، والذي يمكنك الحصول عليه في Google AI Studio.
‫base_url="https://generativelanguage.googleapis.com/v1beta/openai/": يوجّه هذا السطر مكتبة OpenAI لإرسال الطلبات إلى نقطة نهاية Gemini API بدلاً من عنوان URL التلقائي.
model="gemini-3.8-flash": اختيار نموذج Gemini متوافق

جارٍ التفكير

يتم تدريب نماذج Gemini على التفكير في المشاكل المعقّدة، ما يؤدي إلى تحسين كبير في إمكانات الاستدلال. تتضمّن Gemini API مَعلمات التفكير التي تتيح التحكّم بدقة في مقدار التفكير الذي سيقوم به النموذج.

تتضمّن نماذج Gemini المختلفة إعدادات مختلفة للاستدلال، ويمكنك الاطّلاع على كيفية ربطها بجهود الاستدلال التي تبذلها OpenAI على النحو التالي:

`reasoning_effort` (OpenAI)	‫`thinking_level` (Gemini 4 Argon)	`thinking_level` (Gemini 3.1 Flash-Lite)	`thinking_level` (‫Gemini 3 Flash)	`thinking_budget` (Gemini 2.5)
`reasoning_effort` (OpenAI)	‫`thinking_level` (Gemini 4 Argon)	`thinking_level` (Gemini 3.1 Flash-Lite)	`thinking_level` (‫Gemini 3 Flash)	`thinking_budget` (Gemini 2.5)	`minimal`	`low`	`minimal`	`minimal`	`1,024`
`low`	`low`	`low`	`low`	`1,024`
`medium`	`medium`	`medium`	`medium`	`8,192`
`high`	`high`	`high`	`high`	`24,576`

إذا لم يتم تحديد reasoning_effort، يستخدم Gemini المستوى أو الميزانية التلقائيين للنموذج.

إذا أردت إيقاف ميزة التفكير، يمكنك ضبط reasoning_effort على "none" في نماذج 2.5. لا يمكن إيقاف ميزة "الاستدلال" في نموذجَي Gemini 2.5 Pro أو Gemini 3.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.8-flash",
    reasoning_effort="low",
    messages=[
        {   "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Explain to me how AI works"
        }
    ]
)

print(response.choices[0].message)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

const response = await openai.chat.completions.create({
    model: "gemini-3.8-flash",
    reasoning_effort: "low",
    messages: [
        {   role: "system",
            content: "You are a helpful assistant." 
        },
        {
            role: "user",
            content: "Explain to me how AI works",
        },
    ],
});

console.log(response.choices[0].message);

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.8-flash",
    "reasoning_effort": "low",
    "messages": [
      {
        "role": "user",
        "content": "Explain to me how AI works"
      }
    ]
  }'

تُنشئ نماذج Gemini المفكّرة أيضًا ملخّصات للأفكار. يمكنك استخدام الحقل extra_body لتضمين حقول Gemini في طلبك.

يُرجى العِلم أنّ reasoning_effort وthinking_level/thinking_budget تتداخلان في الوظائف، لذا لا يمكن استخدامهما في الوقت نفسه.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[{"role": "user", "content": "Explain to me how AI works"}],
    extra_body={
      'extra_body': {
        "google": {
          "thinking_config": {
            "thinking_level": "low",
            "include_thoughts": True
          }
        }
      }
    }
)

print(response.choices[0].message)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

const response = await openai.chat.completions.create({
    model: "gemini-3.8-flash",
    messages: [{role: "user", content: "Explain to me how AI works",}],
    extra_body: {
      "google": {
        "thinking_config": {
          "thinking_level": "low",
          "include_thoughts": true
        }
      }
    }
});

console.log(response.choices[0].message);

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer GEMINI_API_KEY" \
  -d '{
      "model": "gemini-3.8-flash",
        "messages": [{"role": "user", "content": "Explain to me how AI works"}],
        "extra_body": {
          "google": {
            "thinking_config": {
              "thinking_level": "low",
              "include_thoughts": true
            }
          }
        }
      }'

يتوافق Gemini 3 مع OpenAI في ما يتعلّق بتوقيعات الأفكار في واجهات برمجة التطبيقات لإكمال المحادثات. يمكنك العثور على المثال الكامل في صفحة توقيعات الأفكار.

البث

تتيح Gemini API الردود المتسلسلة.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
  model="gemini-3.8-flash",
  messages=[
    {
        "role": "system",
        "content": "You are a helpful assistant."
    },
    {   "role": "user",
        "content": "Hello!"
    }
  ],
  stream=True
)

for chunk in response:
    print(chunk.choices[0].delta)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function main() {
  const completion = await openai.chat.completions.create({
    model: "gemini-3.8-flash",
    messages: [
      {
          "role": "system",
          "content": "You are a helpful assistant."
      },
      {
          "role": "user",
          "content": "Hello!"
      }
    ],
    stream: true,
  });

  for await (const chunk of completion) {
    console.log(chunk.choices[0].delta.content);
  }
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer GEMINI_API_KEY" \
  -d '{
      "model": "gemini-3.8-flash",
      "messages": [
          {"role": "user", "content": "Explain to me how AI works"}
      ],
      "stream": true
    }'

استدعاء الدالة

تسهّل ميزة "استدعاء الدوال" الحصول على مخرجات بيانات منظَّمة من النماذج التوليدية، وهي متوافقة مع Gemini API.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

tools = [
  {
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Get the weather in a given location",
      "parameters": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "The city and state, e.g. Chicago, IL",
          },
          "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
        },
        "required": ["location"],
      },
    }
  }
]

messages = [{"role": "user", "content": "What's the weather like in Chicago today?"}]
response = client.chat.completions.create(
  model="gemini-3.8-flash",
  messages=messages,
  tools=tools,
  tool_choice="auto"
)

print(response)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function main() {
  const messages = [{"role": "user", "content": "What's the weather like in Chicago today?"}];
  const tools = [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get the weather in a given location",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city and state, e.g. Chicago, IL",
              },
              "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
            },
            "required": ["location"],
          },
        }
      }
  ];

  const response = await openai.chat.completions.create({
    model: "gemini-3.8-flash",
    messages: messages,
    tools: tools,
    tool_choice: "auto",
  });

  console.log(response);
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer GEMINI_API_KEY" \
-d '{
  "model": "gemini-3.8-flash",
  "messages": [
    {
      "role": "user",
      "content": "What'\''s the weather like in Chicago today?"
    }
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "parameters": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. Chicago, IL"
            },
            "unit": {
              "type": "string",
              "enum": ["celsius", "fahrenheit"]
            }
          },
          "required": ["location"]
        }
      }
    }
  ],
  "tool_choice": "auto"
}'

فهم الصور

تتوفّر نماذج Gemini بشكل أصلي مع إمكانات متعدّدة الوسائط، وهي تقدّم أفضل أداء في العديد من مهام الرؤية الشائعة.

Python

import base64
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

# Function to encode the image
def encode_image(image_path):
  with open(image_path, "rb") as image_file:
    return base64.b64encode(image_file.read()).decode('utf-8')

# Getting the base64 string
base64_image = encode_image("Path/to/agi/image.jpeg")

response = client.chat.completions.create(
  model="gemini-3.8-flash",
  messages=[
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image?",
        },
        {
          "type": "image_url",
          "image_url": {
            "url":  f"data:image/jpeg;base64,{base64_image}"
          },
        },
      ],
    }
  ],
)

print(response.choices[0])

JavaScript

import OpenAI from "openai";
import fs from 'fs/promises';

const openai = new OpenAI({
  apiKey: "GEMINI_API_KEY",
  baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function encodeImage(imagePath) {
  try {
    const imageBuffer = await fs.readFile(imagePath);
    return imageBuffer.toString('base64');
  } catch (error) {
    console.error("Error encoding image:", error);
    return null;
  }
}

async function main() {
  const imagePath = "Path/to/agi/image.jpeg";
  const base64Image = await encodeImage(imagePath);

  const messages = [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "What is in this image?",
        },
        {
          "type": "image_url",
          "image_url": {
            "url": `data:image/jpeg;base64,${base64Image}`
          },
        },
      ],
    }
  ];

  try {
    const response = await openai.chat.completions.create({
      model: "gemini-3.8-flash",
      messages: messages,
    });

    console.log(response.choices[0]);
  } catch (error) {
    console.error("Error calling Gemini API:", error);
  }
}

main();

REST

bash -c '
  base64_image=$(base64 -i "Path/to/agi/image.jpeg");
  curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer GEMINI_API_KEY" \
    -d "{
      \"model\": \"gemini-3.8-flash\",
      \"messages\": [
        {
          \"role\": \"user\",
          \"content\": [
            { \"type\": \"text\", \"text\": \"What is in this image?\" },
            {
              \"type\": \"image_url\",
              \"image_url\": { \"url\": \"data:image/jpeg;base64,${base64_image}\" }
            }
          ]
        }
      ]
    }"
'

إنشاء صورة

أنشِئ صورة باستخدام gemini-2.5-flash-image أو gemini-3-pro-image-preview. تشمل المَعلمات المتوافقة prompt وmodel وn وsize وresponse_format. سيتم تجاهل أي مَعلمات أخرى غير مُدرَجة هنا أو في القسم extra_body بدون إشعار من خلال طبقة التوافق.

يمكنك تفعيل تحديد المصدر من خلال "بحث Search" وضبط إعدادات الأمان باستخدام المَعلمة extra_body. يُرجى الاطّلاع على قسم extra_body لمعرفة المَعلمات المتاحة. لا تتوفّر ميزة تحديد المصدر من خلال "بحث Search" إلا في Gemini 3 والنماذج الأحدث.

Python

import base64
from openai import OpenAI
from PIL import Image
from io import BytesIO

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)

response = client.images.generate(
    model="gemini-2.5-flash-image",
    prompt="a portrait of a sheepadoodle wearing a cape",
    response_format='b64_json',
    n=1,
)

for image_data in response.data:
  image = Image.open(BytesIO(base64.b64decode(image_data.b64_json)))
  image.show()

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "GEMINI_API_KEY",
  baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
});

async function main() {
  const image = await openai.images.generate(
    {
      model: "gemini-2.5-flash-image",
      prompt: "a portrait of a sheepadoodle wearing a cape",
      response_format: "b64_json",
      n: 1,
    }
  );

  console.log(image.data);
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer GEMINI_API_KEY" \
  -d '{
        "model": "gemini-2.5-flash-image",
        "prompt": "a portrait of a sheepadoodle wearing a cape",
        "response_format": "b64_json",
        "n": 1,
      }'

إنشاء فيديو

أنشِئ فيديو باستخدام veo-3.1-generate-preview من خلال نقطة نهاية /v1/videos المتوافقة مع Sora. المَعلمات المتوافقة ذات المستوى الأعلى هي prompt وmodel. يجب تمرير مَعلمات إضافية، مثل duration_seconds وimage وaspect_ratio، مع extra_body. يمكنك الاطّلاع على قسم extra_body لمعرفة جميع المَعلمات المتاحة.

إنّ إنشاء الفيديوهات هو عملية طويلة المدى تعرض رقم تعريف عملية يمكنك استطلاعه لمعرفة ما إذا اكتملت العملية.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

# Returns a Long Running Operation (status: processing)
response = client.videos.create(
    model="veo-3.1-generate-preview",
    prompt="A cinematic drone shot of a waterfall",
)

print(f"Operation ID: {response.id}")
print(f"Status: {response.status}")

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function main() {
    // Returns a Long Running Operation (status: processing)
    const response = await openai.videos.create({
        model: "veo-3.1-generate-preview",
        prompt: "A cinematic drone shot of a waterfall",
    });

    console.log(`Operation ID: ${response.id}`);
    console.log(`Status: ${response.status}`);
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/videos" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -F "model=veo-3.1-generate-preview" \
  -F "prompt=A cinematic drone shot of a waterfall"

التحقّق من حالة الفيديو

يتم إنشاء الفيديوهات بشكل غير متزامن. استخدِم GET /v1/videos/{id} لاستطلاع الحالة واسترداد عنوان URL النهائي للفيديو عند اكتمال العملية:

Python

import time
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

# Poll until video is ready
video_id = response.id  # From the create call
while True:
    video = client.videos.retrieve(video_id)
    if video.status == "completed":
        print(f"Video URL: {video.url}")
        break
    elif video.status == "failed":
        print(f"Generation failed: {video.error}")
        break
    print(f"Status: {video.status}. Waiting...")
    time.sleep(10)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function main() {
    // Poll until video is ready
    const videoId = response.id;  // From the create call
    while (true) {
        const video = await openai.videos.retrieve(videoId);
        if (video.status === "completed") {
            console.log(`Video URL: ${video.url}`);
            break;
        } else if (video.status === "failed") {
            console.log(`Generation failed: ${video.error}`);
            break;
        }
        console.log(`Status: ${video.status}. Waiting...`);
        await new Promise(resolve => setTimeout(resolve, 10000));
    }
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/videos/VIDEO_ID" \
  -H "Authorization: Bearer $GEMINI_API_KEY"

فهم الصوت

تحليل المحتوى الصوتي:

Python

import base64
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

with open("/path/to/your/audio/file.wav", "rb") as audio_file:
  base64_audio = base64.b64encode(audio_file.read()).decode('utf-8')

response = client.chat.completions.create(
    model="gemini-3.8-flash",
    messages=[
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Transcribe this audio",
        },
        {
              "type": "input_audio",
              "input_audio": {
                "data": base64_audio,
                "format": "wav"
          }
        }
      ],
    }
  ],
)

print(response.choices[0].message.content)

JavaScript

import fs from "fs";
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "GEMINI_API_KEY",
  baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
});

const audioFile = fs.readFileSync("/path/to/your/audio/file.wav");
const base64Audio = Buffer.from(audioFile).toString("base64");

async function main() {
  const response = await client.chat.completions.create({
    model: "gemini-3.8-flash",
    messages: [
      {
        role: "user",
        content: [
          {
            type: "text",
            text: "Transcribe this audio",
          },
          {
            type: "input_audio",
            input_audio: {
              data: base64Audio,
              format: "wav",
            },
          },
        ],
      },
    ],
  });

  console.log(response.choices[0].message.content);
}

main();

REST

bash -c '
  base64_audio=$(base64 -i "/path/to/your/audio/file.wav");
  curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer GEMINI_API_KEY" \
    -d "{
      \"model\": \"gemini-3.8-flash\",
      \"messages\": [
        {
          \"role\": \"user\",
          \"content\": [
            { \"type\": \"text\", \"text\": \"Transcribe this audio file.\" },
            {
              \"type\": \"input_audio\",
              \"input_audio\": {
                \"data\": \"${base64_audio}\",
                \"format\": \"wav\"
              }
            }
          ]
        }
      ]
    }"
'

ناتج منظَّم

يمكن لنماذج Gemini إخراج عناصر JSON في أي بنية تحدّدها.

Python

from pydantic import BaseModel
from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

class CalendarEvent(BaseModel):
    name: str
    date: str
    participants: list[str]

completion = client.beta.chat.completions.parse(
    model="gemini-3.8-flash",
    messages=[
        {"role": "system", "content": "Extract the event information."},
        {"role": "user", "content": "John and Susan are going to an AI conference on Friday."},
    ],
    response_format=CalendarEvent,
)

print(completion.choices[0].message.parsed)

JavaScript

import OpenAI from "openai";
import { zodResponseFormat } from "openai/helpers/zod";
import { z } from "zod";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai"
});

const CalendarEvent = z.object({
  name: z.string(),
  date: z.string(),
  participants: z.array(z.string()),
});

const completion = await openai.chat.completions.parse({
  model: "gemini-3.8-flash",
  messages: [
    { role: "system", content: "Extract the event information." },
    { role: "user", content: "John and Susan are going to an AI conference on Friday" },
  ],
  response_format: zodResponseFormat(CalendarEvent, "event"),
});

const event = completion.choices[0].message.parsed;
console.log(event);

التضمينات

تقيس تضمينات النصوص مدى صلة السلاسل النصية ببعضها، ويمكن إنشاؤها باستخدام Gemini API. يمكنك استخدام gemini-embedding-2-preview للتضمينات المتعدّدة الوسائط أو gemini-embedding-001 للتضمينات النصية فقط.

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.embeddings.create(
    input="Your text string goes here",
    model="gemini-embedding-2-preview"
)

print(response.data[0].embedding)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

async function main() {
  const embedding = await openai.embeddings.create({
    model: "gemini-embedding-2-preview",
    input: "Your text string goes here",
  });

  console.log(embedding);
}

main();

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/embeddings" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer GEMINI_API_KEY" \
-d '{
    "input": "Your text string goes here",
    "model": "gemini-embedding-2-preview"
  }'

Batch API

يمكنك إنشاء مهام مجمّعة وإرسالها والتحقّق من حالتها باستخدام مكتبة OpenAI.

يجب إعداد ملف JSONL بتنسيق إدخال OpenAI. على سبيل المثال:

{"custom_id": "request-1", "method": "POST", "url": "/v1/chat/completions", "body": {"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Tell me a one-sentence joke."}]}}
{"custom_id": "request-2", "method": "POST", "url": "/v1/chat/completions", "body": {"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Why is the sky blue?"}]}}

يتيح التوافق مع OpenAI في Batch إنشاء دفعة، ومراقبة حالة المهمة، وعرض نتائج الدفعة.

لا يتوفّر حاليًا التوافق مع التحميل والتنزيل. بدلاً من ذلك، يستخدم المثال التالي برنامج genai لتحميل وتنزيل الملفات، تمامًا كما هو الحال عند استخدام Batch API في Gemini.

Python

from openai import OpenAI

# Regular genai client for uploads & downloads
from google import genai
client = genai.Client()

openai_client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

# Upload the JSONL file in OpenAI input format, using regular genai SDK
uploaded_file = client.files.upload(
    file='my-batch-requests.jsonl',
    config=types.UploadFileConfig(display_name='my-batch-requests', mime_type='jsonl')
)

# Create batch
batch = openai_client.batches.create(
    input_file_id=batch_input_file_id,
    endpoint="/v1/chat/completions",
    completion_window="24h"
)

# Wait for batch to finish (up to 24h)
while True:
    batch = client.batches.retrieve(batch.id)
    if batch.status in ('completed', 'failed', 'cancelled', 'expired'):
        break
    print(f"Batch not finished. Current state: {batch.status}. Waiting 30 seconds...")
    time.sleep(30)
print(f"Batch finished: {batch}")

# Download results in OpenAI output format, using regular genai SDK
file_content = genai_client.files.download(file=batch.output_file_id).decode('utf-8')

# See batch_output JSONL in OpenAI output format
for line in file_content.splitlines():
    print(line)

تتيح حزمة تطوير البرامج (SDK) من OpenAI أيضًا إنشاء تضمينات باستخدام Batch API. لإجراء ذلك، استبدِل الحقل endpoint الخاص بالطريقة create بنقطة نهاية خاصة بالتضمينات، بالإضافة إلى المفتاحَين url وmodel في ملف JSONL:

# JSONL file using embeddings model and endpoint
# {"custom_id": "request-1", "method": "POST", "url": "/v1/embeddings", "body": {"model": "ggemini-embedding-001", "messages": [{"role": "user", "content": "Tell me a one-sentence joke."}]}}
# {"custom_id": "request-2", "method": "POST", "url": "/v1/embeddings", "body": {"model": "gemini-embedding-001", "messages": [{"role": "user", "content": "Why is the sky blue?"}]}}

# ...

# Create batch step with embeddings endpoint
batch = openai_client.batches.create(
    input_file_id=batch_input_file_id,
    endpoint="/v1/embeddings",
    completion_window="24h"
)

يمكنك الاطّلاع على قسم إنشاء التضمينات المجمّعة في دليل التوافق مع OpenAI للحصول على مثال كامل.

الاستنتاج المرن والاستنتاج حسب الأولوية

تتطابق المَعلمة service_tier في Gemini API مع تلك الخاصة بـ OpenAI من حيث الاسم والمنطق، ما يفرض حدودًا ويوجّه الزيارات بسلاسة إلى فئتَي الاستنتاج Flex وPriority.

Python

from openai import OpenAI

client = OpenAI(
  api_key="GEMINI_API_KEY",
  base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

completion = client.chat.completions.create(
  model="gemini-3.8-flash",
  messages=[
    {"role": "user", "content": "Write a short poem about clouds."}
  ],
  service_tier="priority" # Or service_tier="flex"
)

print(completion)

في حال عدم تحديد قيمة service_tier بشكل صريح، يتم ضبطها تلقائيًا على standard، أي ما يعادل default في OpenAI. يمكنك الاطّلاع على مزيد من المعلومات عن مستويات الاستدلال في مستندات التحسين.

تفعيل ميزات Gemini باستخدام `extra_body`

هناك العديد من الميزات التي يوفّرها Gemini وغير متاحة في نماذج OpenAI، ولكن يمكن تفعيلها باستخدام الحقل extra_body.

المَعلمة	النوع	نقطة نهاية	الوصف
`cached_content`	نص	محادثة	يتوافق مع ذاكرة التخزين المؤقت العامة لمحتوى Gemini.
`thinking_config`	عنصر	محادثة	يتوافق مع ThinkingConfig في Gemini.
`aspect_ratio`	نص	الصور	نسبة العرض إلى الارتفاع للناتج (مثلاً، `"16:9"` أو `"1:1"` أو `"9:16"`)
`generation_config`	عنصر	الصور	كائن إعدادات إنشاء المحتوى في Gemini (مثل `{"responseModalities": ["IMAGE"], "candidateCount": 2}`)
`safety_settings`	قائمة	الصور	فلاتر مخصّصة لمستوى الأمان (مثل `[{"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_NONE"}]`)
`tools`	قائمة	الصور	تتيح هذه السياسة ميزة "الاستناد إلى مصادر" (مثل `[{"google_search": {}}]`) في `gemini-3-pro-image-preview` فقط.
`aspect_ratio`	نص	فيديو	أبعاد الفيديو الناتج (`16:9` للتنسيق الأفقي، `9:16` للتنسيق العمودي) يتم ضبط القيمة تلقائيًا على "خرائط Google" من `size` في حال عدم تحديد أي قيمة.
`resolution`	نص	فيديو	دقة الإخراج (`720p` و`1080p` و`4K`). ملاحظة: يؤدي الخياران `1080p` و`4K` إلى تفعيل مسار زيادة العيّنات.
`duration_seconds`	عدد صحيح	فيديو	طول المقطع الذي يتم إنشاؤه (القيم: `4` و`6` و`8`). يجب أن يكون `8` عند استخدام `reference_images` أو الاستكمال أو الإضافة.
`frame_rate`	نص	فيديو	عدد اللقطات في الثانية لإخراج الفيديو (مثلاً، `"24"`)
`input_reference`	نص	فيديو	تمثّل هذه السمة الإدخال المرجعي لإنشاء الفيديوهات.
`extend_video_id`	نص	فيديو	معرّف فيديو حالي لإطالة مدته
`negative_prompt`	نص	فيديو	العناصر المطلوب استبعادها (مثلاً، `"shaky camera"`).
`seed`	عدد صحيح	فيديو	عدد صحيح لإنشاء المحتوى بشكل حتمي
`style`	نص	فيديو	النمط المرئي (`cinematic` هو النمط التلقائي، و`creative` هو النمط المحسّن لوسائل التواصل الاجتماعي).
`person_generation`	نص	فيديو	يتحكّم في إنشاء صور لأشخاص (`allow_adult`، `allow_all`، `dont_allow`).
`reference_images`	قائمة	فيديو	ما يصل إلى 3 صور مرجعية للنمط/الشخصية (مواد عرض base64)
`image`	نص	فيديو	صورة الإدخال الأولية المشفرة بتنسيق Base64 لتحديد شروط إنشاء الفيديو
`last_frame`	عنصر	فيديو	الصورة النهائية للاستكمال (تتطلّب استخدام `image` كإطار أول).

مثال على استخدام `extra_body`

إليك مثال على استخدام extra_body لضبط cached_content:

Python

from openai import OpenAI

client = OpenAI(
    api_key=MY_API_KEY,
    base_url="https://generativelanguage.googleapis.com/v1beta/"
)

stream = client.chat.completions.create(
    model="gemini-3.8-flash",
    n=1,
    messages=[
        {
            "role": "user",
            "content": "Summarize the video"
        }
    ],
    stream=True,
    stream_options={'include_usage': True},
    extra_body={
        'extra_body':
        {
            'google': {
              'cached_content': "cachedContents/0000aaaa1111bbbb2222cccc3333dddd4444eeee"
          }
        }
    }
)

for chunk in stream:
    print(chunk)
    print(chunk.usage.to_dict())

عرض النماذج

للحصول على قائمة بنماذج Gemini المتوفّرة، اتّبِع الخطوات التالية:

Python

from openai import OpenAI

client = OpenAI(
  api_key="GEMINI_API_KEY",
  base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

models = client.models.list()
for model in models:
  print(model.id)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "GEMINI_API_KEY",
  baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
});

async function main() {
  const list = await openai.models.list();

  for await (const model of list) {
    console.log(model);
  }
}
main();

REST

curl https://generativelanguage.googleapis.com/v1beta/openai/models \
-H "Authorization: Bearer GEMINI_API_KEY"

استرداد نموذج

استرداد نموذج Gemini:

Python

from openai import OpenAI

client = OpenAI(
  api_key="GEMINI_API_KEY",
  base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

model = client.models.retrieve("gemini-3.8-flash")
print(model.id)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: "GEMINI_API_KEY",
  baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
});

async function main() {
  const model = await openai.models.retrieve("gemini-3.8-flash");
  console.log(model.id);
}

main();

REST

curl https://generativelanguage.googleapis.com/v1beta/openai/models/gemini-3.8-flash \
-H "Authorization: Bearer GEMINI_API_KEY"

القيود الحالية

لا تزال مكتبات OpenAI في مرحلة تجريبية بينما نعمل على توسيع نطاق الميزات المتوافقة.

إذا كانت لديك أسئلة حول المَعلمات المتوافقة أو الميزات القادمة أو واجهت أي مشاكل في بدء استخدام Gemini، يمكنك الانضمام إلى منتدى المطوّرين.

الخطوات التالية

جرِّب Colab المتوافق مع OpenAI للاطّلاع على أمثلة أكثر تفصيلاً.

التوافق مع OpenAI

Python

JavaScript

REST

جارٍ التفكير

Python

JavaScript

REST

Python

JavaScript

REST

البث

Python

JavaScript

REST

استدعاء الدالة

Python

JavaScript

REST

فهم الصور

Python

JavaScript

REST

إنشاء صورة

Python

JavaScript

REST

إنشاء فيديو

Python

JavaScript

REST

التحقّق من حالة الفيديو

Python

JavaScript

REST

فهم الصوت

Python

JavaScript

REST

ناتج منظَّم

Python

JavaScript

التضمينات

Python

JavaScript

REST

Batch API

Python

الاستنتاج المرن والاستنتاج حسب الأولوية

Python

تفعيل ميزات Gemini باستخدام extra_body

مثال على استخدام extra_body

Python

عرض النماذج

Python

JavaScript

REST

استرداد نموذج

Python

JavaScript

REST

القيود الحالية

الخطوات التالية

تفعيل ميزات Gemini باستخدام `extra_body`

مثال على استخدام `extra_body`