Genie 4 API: كيفية الحصول على الوصول المبكر في Gemini API وAI Studio

> > Translate: >

اعتبارًا من 29 أكتوبر 2026، لا توجد واجهة API عامة لـ Genie 4. إن Genie 4 من Google DeepMind، الذي أُعلن عنه في 27 أكتوبر 2026، هو معاينة بحثية للمختبرين الموثوقين، وتقول Google إنه "قريبًا" للشركاء ذوي الوصول المبكر في Gemini API وGoogle AI Studio، مع عدم نشر أي تاريخ أو مستندات أو معرف نموذج أو سعر بعد.

لذا لديك مهمتان: اصطف في الطابور، وابنِ الأجزاء من تطبيق Genie 4 التي تعمل بالفعل على Gemini API العام.

هل توجد واجهة API لـ Genie 4؟

لا. لا يمتلك Genie 4 من Google DeepMind أي API عام، ولا صفحة مرجعية API، ولا معرف نموذج في Gemini API اعتبارًا من 29 أكتوبر 2026. تسمي Google "الشركاء ذوي الوصول المبكر في Gemini API وGoogle AI Studio" كمجموعة تالية بعد المختبرين الموثوقين، لكنها لم تنشر نموذج تقديم أو تاريخًا أو سعرًا لهذا المسار.

إليك ما هو مُعلن وما ليس مُعلنًا:

للحصول على ملخص الميزات، اقرأ شرح Google Genie 4 الخاص بنا. تركز هذه المقالة على API.

ما قالته Google حول الوصول إلى Genie 4 API، بالحرف الواحد

تذكر Google وصول المطورين مرتين في الإعلان. قرب الأعلى:

"لقد بدأنا طرح Genie 4 كمعاينة بحثية للمختبرين الموثوقين، ونجمع الملاحظات قبل إطلاقه للمستهلكين والمطورين، بدءًا من مشتركي Google AI Ultra في Project Genie والشركاء ذوي الوصول المبكر في Gemini API وGoogle AI Studio."

وفي قسم "الخطوات التالية لـ Genie 4":

"تم إصدار Genie 4 كمعاينة بحثية للمختبرين الموثوقين، وسيتوفر قريبًا لمشتركي Google AI Ultra في Project Genie والشركاء ذوي الوصول المبكر في Gemini API وGoogle AI Studio."

اقرأ بعناية: "الشركاء ذوو الوصول المبكر" هم مجموعة مختارة، وليسوا نسخة تجريبية مفتوحة، والرابط الوحيد المرفق هو قائمة انتظار Project Genie للمستهلكين، ولا شيء يذكر ربعًا سنويًا أو يقول "التوفر العام".

تسرد Google أيضًا حدودها الخاصة: تظل البيئات متماسكة "خلال الجلسات القصيرة"، بينما التفاصيل وثبات الأشياء "يمكن أن تتغير أو تنحرف بمرور الوقت".

كيف تحصل على الوصول المبكر إلى Genie 4 اليوم

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

1. انضم إلى قائمة انتظار Genie 4. انقر على "انضم إلى قائمة انتظار Genie 4" في منشور Google DeepMind. يفتح نموذج قائمة الانتظار الخاص بـ Google لـ Project Genie. إنه ليس برنامجًا للمطورين، لكنه الإشارة الوحيدة التي طلبتها Google.
2. احصل على مفتاح Gemini API وحساب فوترة. أنشئ مفتاحًا في Google AI Studio. مشروع Gemini API نشط هو رهان معقول للشركاء، وليس قاعدة مُعلنة.
3. راقب مستندات Gemini API. تحقق من صفحة النماذج وملاحظات الإصدار في الشريط الجانبي للمستندات.
4. ابنِ على Interactions API. يقول دليل Interactions API من Google "سيتم إطلاق جميع النماذج الجديدة والقدرات متعددة الوسائط والأدوات والميزات الوكيلية على Interactions API." لم يُذكر Genie 4 هناك، ولكن إذا وصل إلى Gemini API، فهذا هو الافتراضي المُعلن.
5. اطلق شيئًا على شكل نموذج عالمي. يأتي مختبرو Google من الصناعات الإبداعية والصحافة والتعليم والألعاب والهندسة.

لمعرفة تكلفة Project Genie، راجع هل Project Genie مجاني؟، وللنماذج العالمية التي يمكنك تجربتها اليوم، راجع بدائل Project Genie.

ما يمكنك بناؤه اليوم باستخدام Gemini API

Genie 4 ليس نموذجًا منفردًا. تصف Google Gemini 3.8 Flash بأنه "وكيل موجّه في الحلقة": يلاحظ المشهد، ويقسم الهدف إلى خطوات، "يراجع الإطارات الواردة لتتبع التقدم ويؤكد أن كل خطوة قد نجحت"، ويكيّف الخطة عندما يتدخل المستخدم.

هذا النصف المشرف عام الآن. gemini-3.8-flash موجود على Gemini API، مع طبقة مجانية وأسعار مدفوعة تبلغ 0.75 دولار لكل مليون رمز إدخال و3.75 دولار لكل مليون رمز إخراج حتى 31 ديسمبر 2026، وفقًا لـ صفحة أسعار Gemini API. يمكنك توجيهه إلى إطارات من أي مصدر اليوم (محرك لعبة، مسجل شاشة، تسجيل Genie 3) واستبدالها بإطارات Genie 4 لاحقًا.

إليك مشرفًا بسيطًا بلغة Python، بناءً على أشكال الطلبات في مستندات فهم الصور من Google. احتفظ باسم النموذج في متغير حتى تتمكن من استبداله في يوم الإطلاق:

import base64, json, os
from google import genai

MODEL = os.environ.get("SUPERVISOR_MODEL", "gemini-3.8-flash")
client = genai.Client()  # reads GEMINI_API_KEY

PLAN = {"type": "object", "properties": {
    "steps": {"type": "array", "items": {"type": "string"}}}, "required": ["steps"]}
VERDICT = {"type": "object", "properties": {
    "done": {"type": "boolean"}, "reason": {"type": "string"}}, "required": ["done", "reason"]}

def frame(path):
    with open(path, "rb") as f:
        return {"type": "image", "mime_type": "image/png",
                "data": base64.b64encode(f.read()).decode()}

def ask(text, image, schema, previous=None):
    kwargs = dict(model=MODEL, input=[{"type": "text", "text": text}, image],
                  response_format={"type": "text", "mime_type": "application/json",
                                   "schema": schema})
    if previous:
        kwargs["previous_interaction_id"] = previous
    turn = client.interactions.create(**kwargs)
    return turn.id, json.loads(turn.output_text)

goal = "The character walks to the red door and opens it."
turn_id, plan = ask(f"Goal: {goal}\nBreak it into short visual steps.",
                    frame("frame_000.png"), PLAN)

for i, step in enumerate(plan["steps"], start=1):
    turn_id, verdict = ask(f"Step {i}: {step}\nDoes this frame show it done?",
                           frame(f"frame_{i:03d}.png"), VERDICT, previous=turn_id)
    print(i, step, verdict)
    if not verdict["done"]:
        break  # re-plan here, or send a steering prompt to your simulator

تفصيلان يحملان الحلقة. response_format مع مخطط JSON يبقي كل إجابة قابلة للقراءة آليًا، وprevious_interaction_id يسمح للخادم بالاحتفاظ بالخطة بين الأدوار، لذلك لا تعيد إرسال السجل. تخزن Interactions API الطلبات افتراضيًا؛ اضبط store=False إذا كنت بحاجة إلى استدعاءات عديمة الحالة.

لم نجرّب هذا مقابل مفتاح حي، لذا اختبره على إطاراتك الخاصة أولاً.

للحصول على شرح أكثر شمولاً للنموذج، راجع كيفية استخدام Gemini 3.8 Flash API.

اختبر طلبات المشرف باستخدام Apidog CLI

المشرف الذي يغير شكل JSON الخاص به بهدوء يكسر حلقتك. سلّم التحقق إلى وكيل البرمجة الخاص بك وApidog CLI:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

ثم أعطِ Claude Code أو Codex أو Cursor مطالبة واحدة:

In Apidog project <id>, create a test case for POST
https://generativelanguage.googleapis.com/v1beta/interactions with header
x-goog-api-key from the {{GEMINI_API_KEY}} environment variable. Send model
gemini-3.8-flash, a short goal, one base64 PNG frame and a response_format JSON
schema with "done" (boolean) and "reason" (string). Assert status 200 and that
output_text parses as JSON with both fields. Run it against the gemini
environment and summarize any failures.

يبحث الوكيل عن شكل الحمولة بدلاً من تخمينه، ويتحقق من الملف، وينشئ الحالة ويشغلها:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json

هناك علمان في apidog run يستحقان الإضافة لحلقة الرؤية. -n, --iteration-count <n> يكرر الحالة حتى تتمكن من اكتشاف الأحكام غير المستقرة، و-d, --iteration-data <path> يغذي ملف CSV أو JSON من الإطارات والأهداف، واحد لكل تكرار. عندما يتم إصدار معرف نموذج Genie 4، يمكنك تغيير متغير بيئة واحد وإعادة التشغيل.

استبدل -r cli,json بـ -r junit وسيندرج نفس التشغيل في CI. يوضح دليل Apidog CLI CI/CD الخاص بنا خط الأنابيب، ويغطي Apidog CLI في Claude Code إعداد الوكيل. تغطي خطة Apidog المجانية ما يصل إلى 4 مستخدمين.

ما يجب مراقبته عند إطلاق Genie 4 API

لم تصف Google الـ API. تحدد هذه الأسئلة كيفية دمجه:

خطط لها الآن: احتفظ باسم النموذج وعنوان URL الأساسي وحسابات التسعير في التهيئة، وضع مصدر الإطارات خلف واجهة واحدة، وسجّل كل إطار وحكم، لأن Google تقول إن الانحراف يزداد مع طول الجلسة.

إذا كنت قادمًا من Genie 3، فإن نظرة عامة على Google Genie 3 وكيفية استخدام Google Genie 3 يغطيان النموذج السابق.

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

هل يوجد مفتاح API لـ Genie 4؟ ليس بعد. لا يظهر أي نموذج Genie 4 في Gemini API اعتبارًا من 29 أكتوبر 2026. مفتاح Gemini API القياسي من Google AI Studio يعمل مع gemini-3.8-flash، النموذج الذي تستخدمه Google كمشرف لـ Genie 4، لكنه لا يفتح Genie 4.

كيف أصبح شريكًا للوصول المبكر في Gemini API لـ Genie 4؟ لم تنشر Google عملية. انضم إلى قائمة انتظار Project Genie، واحتفظ بمشروع Gemini API نشط، وراقب صفحة نماذج Gemini API وملاحظات الإصدار للإعلان.

هل توجد واجهة API لـ Project Genie؟ لا. Project Genie هو تجربة للمستهلكين على labs.google/projectgenie. تدرج Google Gemini API وGoogle AI Studio كمسار المطورين لـ Genie 4.

كم ستكلف واجهة Genie 4 API؟ لم تعلن Google عن التسعير أو طبقة مجانية أو وحدة فوترة. اعتبر أي رقم تراه قبل صفحة تسعير رسمية تخمينًا.

هل يمكنني اختبار Genie 4 في Google AI Studio اليوم؟ لا، إلا إذا كنت مختبرًا موثوقًا. تقول Google إن شركاء الوصول المبكر في AI Studio هم التاليون، دون تحديد تاريخ.