|

3 خطوات لإكمال الانتقال من Google AI Studio إلى APIYI: احتفظ بالكود وغير إعدادين فقط

ملاحظة المؤلف: دليل مفصل حول كيفية نقل تطبيقات Google AI Studio إلى منصة APIYI، حيث يكفي تعديل عنوان الطلب ومفتاح API فقط للاستمتاع بأسعار Gemini المخفضة التي تصل إلى 20% من السعر الأصلي.

هل ترغب في نقل تطبيق قمت ببرمجته باستخدام Google AI Studio إلى منصة أخرى؟ يقلق الكثير من المطورين من حجم التعديلات البرمجية المطلوبة. في الواقع، لا يتطلب الأمر سوى تعديل إعدادين فقط: عنوان الطلب (Request Address) ومفتاح API (API Key)، ليعمل تطبيقك بسلاسة على منصة APIYI وبأسعار أكثر تنافسية.

القيمة المحورية: بنهاية هذا المقال، ستكون قد تعلمت خطوات النقل الكاملة من Google AI Studio، وتعرفت على المزايا السعرية لنماذج Gemini على منصة APIYI.

google-ai-studio-migrate-to-apiyi-guide-ar 图示


النقاط الجوهرية للنقل من Google AI Studio إلى APIYI

النقطة الشرح الفائدة
تعديل إعدادين فقط تغيير base_url و api_key حجم تعديل الكود ضئيل جداً، وتكلفة النقل منخفضة
توافق تام مع Gemini API دعم تنسيق نقطة النهاية /v1beta لا حاجة لتعديل بارامترات الطلب أو معالجة الاستجابة
ميزة سعرية واضحة تبدأ أسعار Nano Banana Pro من $0.05 للطلب أقل بنسبة تصل إلى 80% مقارنة بالسعر الرسمي
دعم أنماط فوترة متعددة خيارات الدفع لكل طلب أو حسب الاستهلاك مرونة عالية تتناسب مع مختلف سيناريوهات الاستخدام

النقاط التقنية الأساسية لعملية النقل

عنوان API الأساسي لـ Google AI Studio هو generativelanguage.googleapis.com وتنسيق مسار الطلب الكامل هو:

https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent

عند الانتقال إلى APIYI، ما عليك سوى استبدال العنوان الأساسي بـ api.apiyi.com مع الحفاظ على نفس تنسيق المسار:

https://api.apiyi.com/v1beta/models/{model}:generateContent

تتوافق منصة APIYI تماماً مع بروتوكول Google Gemini API، بما في ذلك جميع نقاط النهاية الرئيسية مثل generateContent و streamGenerateContent و embedContent وغيرها، مما يعني أن منطق الكود الحالي الخاص بك لن يحتاج إلى أي تغيير.

google-ai-studio-migrate-to-apiyi-guide-ar 图示


بدء سريع: الانتقال من Google AI Studio إلى APIYI

مثال مبسط

فيما يلي أبسط مقارنة للانتقال؛ تحتاج فقط إلى تعديل سطرين في كود Python:

import google.generativeai as genai

# الإعداد الأصلي لـ Google AI Studio
# genai.configure(api_key="YOUR_GOOGLE_API_KEY")

# إعداد APIYI بعد الانتقال (قم بتغيير هذين السطرين فقط)
genai.configure(
    api_key="YOUR_APIYI_KEY",
    transport="rest",
    client_options={"api_endpoint": "api.apiyi.com"}
)

model = genai.GenerativeModel("gemini-2.0-flash")
response = model.generate_content("Hello!")
print(response.text)

عرض مثال استدعاء REST API المباشر
import requests

# نقطة نهاية APIYI Gemini API
url = "https://api.apiyi.com/v1beta/models/gemini-2.0-flash:generateContent"

headers = {
    "Content-Type": "application/json",
    "x-goog-api-key": "YOUR_APIYI_KEY"
}

payload = {
    "contents": [{
        "parts": [{"text": "عرّف الذكاء الاصطناعي في جملة واحدة"}]
    }]
}

response = requests.post(url, headers=headers, json=payload)
result = response.json()

# استخراج النص المُنشأ
text = result["candidates"][0]["content"]["parts"][0]["text"]
print(text)

عرض مثال الانتقال لـ JavaScript/Node.js
const { GoogleGenerativeAI } = require("@google/generative-ai");

// حدد نقطة نهاية APIYI عند إنشاء العميل
const genAI = new GoogleGenerativeAI("YOUR_APIYI_KEY", {
  baseUrl: "https://api.apiyi.com/v1beta"
});

const model = genAI.getGenerativeModel({ model: "gemini-2.0-flash" });

async function run() {
  const result = await model.generateContent("Hello!");
  console.log(result.response.text());
}

run();

نصيحة: قم بتسجيل حساب عبر APIYI (apiyi.com) للحصول على مفتاح API. توفر المنصة رصيد اختبار مجاني للتحقق من فعالية الانتقال بسرعة.


مقارنة حلول الانتقال من Google AI Studio

google-ai-studio-migrate-to-apiyi-guide-ar 图示

معيار المقارنة Google الرسمي منصة APIYI توضيح المزايا
سعر Gemini 3 Pro $2.00/مليون مدخلات سعر أكثر توفيراً حسب الاستخدام تقليل تكاليف استدعاء API بشكل كبير
Nano Banana Pro لا يتوفر $0.05/للمرة (20% من السعر الرسمي) مناسب لسيناريوهات الطلبات الصغيرة المتكررة
عنوان الطلب (Endpoint) generativelanguage.googleapis.com api.apiyi.com وصول محلي أكثر استقراراً
طريقة المحاسبة الدفع حسب الاستخدام فقط نظام مزدوج (لكل مرة / حسب الاستخدام) مرونة في اختيار الحل الأنسب
الرصيد المجاني محدود رصيد اختبار عند التسجيل الاختبار الكامل قبل اتخاذ القرار

تفاصيل أسعار نماذج Gemini على APIYI

اسم النموذج طريقة المحاسبة السعر سيناريوهات الاستخدام
Nano Banana Pro حسب المرة $0.05/للمرة محادثات خفيفة، أسئلة وأجوبة سريعة
gemini-3-pro-preview حسب الاستخدام سعر مخفض استنتاج معقد، توليد نصوص طويلة
gemini-2.0-flash حسب الاستخدام سعر مخفض محادثات يومية، إنشاء محتوى
gemini-2.5-flash حسب الاستخدام سعر مخفض مهام متعددة الوسائط، فهم الصور

ملاحظة المقارنة: تعتمد مقارنة الأسعار أعلاه على بيانات يناير 2026، يمكنك الاطلاع على أحدث الأسعار عبر APIYI (apiyi.com).


خطوات تصدير ونقل الكود من Google AI Studio

يوفر Google AI Studio ميزات مريحة لتصدير الكود، حيث يمكنك:

  1. تصدير كملف ZIP: اضغط على أيقونة التنزيل في واجهة AI Studio للحصول على كود المشروع كاملاً.
  2. الدفع إلى GitHub: مزامنة الكود مع مستودع GitHub بضغطة زر واحدة.
  3. النشر على Cloud Run: نشر الكود بسرعة كخدمة عبر الإنترنت.

قائمة التحقق الخاصة بعملية النقل

أكمل الخطوات التالية لإتمام عملية النقل بنجاح:

  • تصدير كود المشروع من Google AI Studio (سواء كملف ZIP أو عبر GitHub).
  • التسجيل في APIYI عبر الموقع apiyi.com والحصول على مفتاح API (API Key).
  • تعديل عنوان النهاية api_endpoint في الكود إلى api.apiyi.com.
  • استبدال مفتاح api_key بالمفتاح الخاص بك من APIYI.
  • تشغيل الاختبارات للتأكد من أن جميع الوظائف تعمل بشكل صحيح.
  • اختيار نظام المحاسبة المناسب (الدفع لكل مرة أو حسب كمية الاستهلاك) بناءً على حجم استخدامك.

الأسئلة الشائعة

س1: هل أحتاج لتعديل بارامترات الطلب بعد عملية النقل؟

لا داعي لذلك. منصة APIYI متوافقة تماماً مع تنسيق وبارامترات طلبات Google Gemini API، بما في ذلك contents و generationConfig و safetySettings وجميع البارامترات القياسية الأخرى، لذا يمكنك استخدامها مباشرة.

س2: كيف أختار بين خطة الدفع لكل مرة وخطة الدفع حسب الاستهلاك في Nano Banana Pro؟

تعد خطة الدفع لكل مرة مثالية للحالات التي يكون فيها محتوى الطلب الواحد قليلاً (مثل الأسئلة والأجوبة القصيرة)، حيث تبلغ التكلفة الثابتة 0.05 دولار لكل طلب؛ أما خطة الدفع حسب الاستهلاك فهي الأنسب لإنشاء النصوص الطويلة أو عمليات المعالجة الجماعية، حيث يتم احتساب التكلفة بناءً على عدد الـ tokens المستخدمة فعلياً. يمكنك التبديل بين وضعي الدفع من خلال لوحة تحكم APIYI في apiyi.com.

س3: كيف يمكنني البدء بالاختبار بسرعة؟

نوصي باستخدام منصة تجميع API التي تدعم نماذج متعددة لإجراء الاختبارات:

  1. قم بزيارة موقع APIYI (apiyi.com) وتسجيل حساب.
  2. احصل على مفتاح API ورصيد مجاني.
  3. استخدم أمثلة الكود الموجودة في هذا المقال للتحقق من التشغيل بسرعة.

ملخص

النقاط الأساسية للانتقال من Google AI Studio إلى APIYI:

  1. تعديلات طفيفة للغاية: تحتاج فقط إلى تعديل إعدادين هما عنوان الطلب (Request URL) ومفتاح واجهة البرمجيات (API Key).
  2. توافق تام: يدعم APIYI جميع نقاط النهاية (Endpoints) وتنسيقات المعلمات الخاصة بـ Gemini API.
  3. ميزة السعر: تبلغ تكلفة Nano Banana Pro حوالي 0.05 دولار للمرة الواحدة، وهو ما يعادل 20% فقط من السعر الرسمي (خصم 80%).

إذا كنت تستخدم Google AI Studio لتطوير التطبيقات، وترغب في تقليل تكاليف الـ API أو تحسين استقرار الوصول، فإن الانتقال إلى APIYI هو خيار يستحق الدراسة.

نوصي بالتحقق من النتائج بسرعة عبر APIYI (apiyi.com)، حيث توفر المنصة رصيداً مجانياً وواجهة موحدة لعدة نماذج.


📚 مراجع إضافية

⚠️ توضيح لتنسيق الروابط: تستخدم جميع الروابط الخارجية تنسيق اسم المصدر: domain.com لسهولة النسخ ولكنها غير قابلة للنقر، وذلك لتجنب فقدان وزن تحسين محركات البحث (SEO).

  1. وثائق Google AI Studio الرسمية: دليل استخدام Gemini API

    • الرابط: ai.google.dev/gemini-api/docs
    • الوصف: تعرف على الميزات الكاملة وتفاصيل المعلمات لـ Gemini API.
  2. صفحة تسعير Gemini API: مرجع الأسعار الرسمي

    • الرابط: ai.google.dev/gemini-api/docs/pricing
    • الوصف: قارن بين الأسعار الرسمية ونسبة الخصم التي يقدمها APIYI.
  3. Google AI Studio Build Mode: شرح ميزة تصدير الكود

    • الرابط: ai.google.dev/gemini-api/docs/aistudio-build-mode
    • الوصف: تعلم كيفية تصدير كود المشروع من AI Studio.

المؤلف: الفريق التقني
تبادل الخبرات: نرحب بنقاشاتكم في قسم التعليقات، ولمزيد من المعلومات يمكنكم زيارة المجتمع التقني لـ APIYI على apiyi.com

موضوعات ذات صلة