| تفترض الأمثلة الواردة في هذه الصفحة أنّك أكملت الخطوات الواردة في مقالة البدء: الوصول إلى Gemini API من خلال إطار عمل Foundation Models من Apple. |
يوضّح لك هذا الدليل كيفية إرسال أنواع مختلفة من الطلبات إلى Gemini API من خلال إطار عمل Foundation Models من Apple باستخدام حزمة تطوير البرامج (SDK) لـ Firebase AI Logic على أنظمة Apple الأساسية.
تعرض هذه الصفحة أمثلة على كيفية إرسال أنواع الطلبات التالية:
- إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
- إنشاء نصّ من إنشاء الذكاء الاصطناعي خلال محادثة مترابطة (محادثة)
- إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال متعدد الوسائط (مثل الصور)
- إنشاء صور من إدخال نصي فقط
إنشاء نص
تتيح نماذج Gemini الإمكانات التالية لإنشاء نصّ من إنشاء الذكاء الاصطناعي:
- إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
- إنشاء نصّ من إنشاء الذكاء الاصطناعي خلال محادثة مترابطة (محادثة)
- إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال متعدد الوسائط (مثل الصور)
النماذج التي تتيح هذه الميزة
gemini-4-hydrogengemini-4-argongemini-4-carbongemini-3.8-flash-
gemini-3.5-flash-lite(والإصدار الأقدمgemini-3.1-flash-lite)
تتيح نماذج Gemini 3.x Flash القديمة ذات الاستخدام العام هذه الإمكانية، ولكن لا يُنصح باستخدامها بعد الآن بسبب تواريخ الإيقاف القادمة و/أو إعادة التوجيه التلقائي إلى النماذج الأحدث.
إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال نصي فقط
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
يمكنك أن تطلب من نموذج Gemini إنشاء نص من خلال إدخال طلب نصي فقط.
import FoundationModels
import FirebaseCore
import FirebaseAILogic
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-4-hydrogen")
// Provide a prompt that contains text.
let prompt = "Write a story about a magic backpack."
// Create a session by injecting the model into Apple's `LanguageModelSession`.
// For a single-turn interaction, create a new session each time you call the model.
let session = LanguageModelSession(model: model)
// Generate a text response to the prompt.
let response = try await session.respond(to: prompt)
print(response.content)
عرض الرد تدريجيًا
يمكنك تحقيق تفاعلات أسرع من خلال عدم انتظار النتيجة الكاملة من
إنشاء النموذج، واستخدام البث بدلاً من ذلك للتعامل مع النتائج الجزئية. لبثّ الردّ، استخدِم streamResponse(to:) بدلاً من respond(to:).
// imports
// initialization of Gemini API backend service and a `geminiLanguageModel`
// Provide a prompt that contains text.
let prompt = "Write a story about a magic backpack."
// Create a session by injecting the model into Apple's `LanguageModelSession`.
// For a single-turn interaction, create a new session each time you call the model.
let session = LanguageModelSession(model: model)
// Generate a text response to the prompt.
// To stream the response, use `streamResponse(to:)` instead of `respond(to:)`
let stream = session.streamResponse(to: "Write a story about a magic backpack.")
var response = ""
for try await snapshot in stream {
// The snapshot contains *all* content generated so far.
response = snapshot.content
}
إنشاء نصّ من إنشاء الذكاء الاصطناعي خلال محادثة مترابطة (محادثة)
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
import FoundationModels
import FirebaseCore
import FirebaseAILogic
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-4-hydrogen")
// Create a session by injecting the model into Apple's `LanguageModelSession`.
// The session maintains state between each request.
let session = LanguageModelSession(model: model)
// Generate a text response to an initial prompt.
let response = try await session.respond(to: "Hello! I'd like to learn more about Albert Einstein.")
print(response.content) // Example response from model: "What would you like to know?"
// Continue using the existing session. Each prompt and response is added to the transcript.
let response2 = try await session.respond(to: "When was he born?")
print(response2.content) // Example response from model: "March 14, 1879"
إنشاء نصّ من إنشاء الذكاء الاصطناعي من إدخال متعدد الوسائط (مثل الصور)
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
يمكنك أن تطلب من نموذج Gemini إنشاء نصّ من إنشاء الذكاء الاصطناعي من خلال توجيه طلب باستخدام نص وملف، مثل صورة أو ملف PDF.
import FoundationModels
import FirebaseCore
import FirebaseAILogic
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "gemini-4-hydrogen")
// Create a session by injecting the model into Apple's `LanguageModelSession`.
// For a single-turn interaction, create a new session each time you call the model.
let session = LanguageModelSession(model: model)
let cgImage: CGImage = // ... fetch CGImage from your datasource.
let response = try await session.respond {
"What are the dominant colors of this image, in order?"
Attachment(cgImage)
}
print(response.content)
عرض الرد تدريجيًا
يمكنك تحقيق تفاعلات أسرع من خلال عدم انتظار النتيجة الكاملة من
إنشاء النموذج، واستخدام البث بدلاً من ذلك للتعامل مع النتائج الجزئية. لبثّ الردّ، استخدِم streamResponse بدلاً من respond.
// imports
// initialization of Gemini API backend service and a `geminiLanguageModel`
// Create a session by injecting the model into Apple's `LanguageModelSession`.
// For a single-turn interaction, create a new session each time you call the model.
let session = LanguageModelSession(model: model)
let cgImage: CGImage = // ... fetch CGImage from your datasource.
let stream = session.streamResponse {
"What are the dominant colors of this image, in order?"
Attachment(cgImage)
}
var response = ""
for try await snapshot in stream {
// The snapshot contains *all* content generated so far.
response = snapshot.content
}
print(response)
إنشاء صور (باستخدام نماذج Nano Banana)
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
النماذج التي تتيح هذه الميزة
gemini-nano-banana-2.1(Nano Banana 2.1)gemini-3.1-flash-image(Nano Banana 2)gemini-3.1-flash-lite-image(Nano Banana 2 Lite)gemini-3-pro-image(Nano Banana Pro)
يمكنك أن تطلب من نموذج Gemini Nano Banana إنشاء صورة من خلال إدخال طلب نصي فقط.
يوضّح المثال التالي كيفية إنشاء صورة فقط، ولكن يمكن لنماذج Nano Banana إنشاء كل من الصور والنصوص.
import FoundationModels
import FirebaseCore
import FirebaseAILogic
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports image output.
let model = ai.geminiLanguageModel(name: "gemini-nano-banana-2.1"
options:
GeminiGenerationOptions(responseModalities: .image)
)
let session = LanguageModelSession(model: model)
let response = try await session.respond(
to: "Generate an image of the Eiffel tower with fireworks in the background."
)
var generatedImage: CIImage?
// Find the image in the transcriptEntries.
for entry in response.transcriptEntries {
if case let .response(response) = entry {
for segment in response.segments {
if case let .attachment(attachment) = segment,
case let .image(image) = attachment.content {
generatedImage = image.ciImage
}
}
}
}
إنشاء مخرجات JSON منظَّمة
|
انقر على مزوّد خدمة Gemini API للاطّلاع على المحتوى والرمز البرمجي الخاصَّين بمزوّد الخدمة على هذه الصفحة. |
النماذج التي تتيح هذه الميزة
gemini-4-hydrogengemini-4-argongemini-4-carbongemini-3.8-flash-
gemini-3.5-flash-lite(والإصدار الأقدمgemini-3.1-flash-lite) gemini-3-pro-image(Nano Banana Pro)
تتيح نماذج Gemini 3.x Flash القديمة ذات الاستخدام العام هذه الإمكانية، ولكن لا يُنصح باستخدامها بعد الآن بسبب تواريخ الإيقاف القادمة و/أو إعادة التوجيه التلقائي إلى النماذج الأحدث.
تعرض نماذج Gemini الردود كنص غير منظَّم تلقائيًا. ومع ذلك، تتطلّب بعض حالات الاستخدام نصًا منظّمًا، مثل JSON. على سبيل المثال، قد تستخدم الردّ لمهام أخرى تالية تتطلّب مخطّط بيانات محدّدًا.
يمكنك ضبط النموذج لتنسيق ردّه وفقًا لمخطط JSON الذي تقدّمه. للحصول على تفاصيل وأفضل الممارسات وحالات الاستخدام لإنشاء مخرجات JSON منظَّمة، يُرجى الاطّلاع على الدليل العام إنشاء مخرجات منظَّمة.
import FoundationModels
import FirebaseCore
import FirebaseAILogic
@Generable(description: "Basic profile information about a cat")
struct CatProfile {
var name: String
@Guide(description: "The age of the cat", .range(0 ... 20))
var age: Int
@Guide(description: "A one sentence profile about the cat's personality")
var profile: String
}
// Initialize the Gemini Developer API backend service.
let ai = FirebaseAI.firebaseAI(backend: .googleAI())
// Initialize a `geminiLanguageModel` with a Gemini model that supports your use case.
let model = ai.geminiLanguageModel(name: "GEMINI_MODEL_NAME")
let session = LanguageModelSession(model: model)
let response = try await session.respond(
to: "Generate a cute rescue cat profile with an Elvish theme",
generating: CatProfile.self
)
let cat = response.content
تقديم ملاحظات حول الوصول إلى "Gemini API" من خلال إطار عمل Foundation Models من Apple