ملاحظة الكاتب: يعتمد الشرح على خطوات لوحة التحكم، ويبيّن كيفية ربط GPT-6.1 Terra API في 5 خطوات، مع توضيح اختيار نقطة النهاية، وأخطاء المعلمات الشائعة، والتسعير المتدرج عند 272K.
الخلاصة أولًا: عند ربط GPT-6.1 Terra، عليك اتخاذ قرار واحد أساسي: استخدام Responses أم Chat Completions. إذا كنت تحتاج إلى استدعاء الأدوات، فلا بد من استخدام Responses. أما إذا لم تكن بحاجة إليها، فيمكنك غالبًا استخدام الشفرة الحالية كما هي، مع تغيير اسم النموذج فقط.
أُطلق GPT-6.1 Terra في 2026-10-26، ومعرّف النموذج هو gpt-6.1-terra. وتوضح الوثائق الرسمية نقاط النهاية والمعلمات وقواعد التسعير، لذا فهذه المعلومات موثقة. يتبع المقال ترتيب الخطوات في لوحة التحكم: التسجيل → إنشاء رمز → العثور على Base URL → إدخال اسم النموذج → إرسال الطلب الأول. وتتضمن كل خطوة معيارًا للتحقق من نجاحها، أما سطر الأوامر والشفرة فهما طريقتان اختياريتان.
الفائدة الأساسية: بعد قراءة هذا المقال، ستتمكن من التحقق من اكتمال ربط GPT-6.1 Terra API عبر لوحة التحكم، وتفادي أكثر أخطاء 400 شيوعًا.
📌 توضيح حول حالة المنصة: حتى 2026-10-27، لا يظهر
gpt-6.1-terraبعد في قائمة النماذج المباشرة على APIYI apiyi.com، وسنعمل على إتاحته في أقرب وقت. أما النماذج من الجيل نفسه، وهيgpt-6-astraوgpt-6-solوgpt-6.1-solوgpt-6-luna، فهي متاحة بالفعل. ويمكنك استخدامgpt-6.1-solللتحقق من مسار الربط في الوقت الحالي. يُرجى الرجوع إلى قائمة النماذج على المنصة للاطلاع على النماذج والأسعار.
النقاط الأساسية في GPT-6.1 Terra API
| النقطة | التوضيح | ما يعنيه ذلك لك |
|---|---|---|
| معرّف النموذج | gpt-6.1-terra، أُطلق في 2026-10-26 |
أدخل هذه القيمة في حقل model ضمن الطلب |
| نقاط النهاية المتاحة | Responses وChat Completions وBatch | نقاط النهاية Realtime وAssistants وEmbeddings وغيرها غير مدعومة |
| استدعاء الأدوات | لا تدعمه إلا Responses | ستفشل طلبات Chat التي تتضمن tools مباشرةً |
| السياق | الإجمالي 1,050,000، والحد الأقصى للإدخال في الطلب الواحد 922,000، والإخراج 128,000 | مناسب للمستندات الطويلة، لكن انتبه إلى شريحة التسعير عند 272K |
| الوسائط | النصوص والصور للإدخال، والنص للإخراج | أرسل الصور عبر input_image في Responses |
| المعرفة حتى تاريخ | 2026-06-01 | للحصول على معلومات أحدث، استخدم أداة web_search |
شرح مفصّل لحدود قدرات GPT-6.1 Terra
يدعم GPT-6.1 Terra البث والمخرجات المنظّمة واستدعاء الدوال وfile_search وإدخال الصور والبحث على الويب والتخزين المؤقت للموجهات. لكنه لا يدعم الضبط الدقيق أو المخرجات المتوقعة. إذا كان مشروعك القديم يعتمد على نماذج مضبوطة بدقة أو على المخرجات المتوقعة، فلن تتمكن من نقله إليه مباشرةً.
يمكن إرفاق أدوات كثيرة بنقطة النهاية Responses، منها web_search وfile_search وimage_generation وcode_interpreter وhosted_shell وapply_patch وskills وcomputer_use وmcp وtool_search. وهذا هو السبب الأساسي لاختيار Responses عند الحاجة إلى الأدوات: فـChat Completions لا يتولى في هذا النموذج سوى المحادثات النصية البحتة.
كيفية استدعاء GPT-6.1 Terra API: خطوات الإعداد في وحدة التحكم خلال 5 مراحل
الخطوة الأولى: إنشاء حساب
- افتح APIYI على apiyi.com، واتبع التعليمات لإنشاء حساب باستخدام بياناتك الشخصية؛ إذ تشترط المنصة التسجيل بنفسك.
- يتضمن الحساب الجديد رصيدًا تجريبيًا بقيمة 0.05 دولار، ويمكنك استخدامه لإجراء استدعاء بسيط من دون شحن الرصيد.
- معيار التحقق: بعد تسجيل الدخول، انتقل إلى وحدة التحكم وتحقق من ظهور الرصيد التجريبي في صفحة المحفظة أو الرصيد.
- إذا واجهت مشكلة: إذا لم يظهر الرصيد، فتحقق أولًا من إتمام خطوات التسجيل، ولا تتسرع في شحن الرصيد.
إذا أردت استخدام القناة الرسمية، فأنشئ مفتاحًا من صفحة API Keys على منصة OpenAI. يشترط لذلك أن يكون حسابك في منطقة مدعومة، وأن تكون قد شحنت رصيدًا إلى مستوى Build، أي ما لا يقل عن 5 دولارات.
الخطوة 2: أنشئ رمزًا واختر المجموعة المناسبة
- انتقل إلى صفحة الرموز في لوحة التحكم
api.apiyi.com/token، ثم انقر على «إنشاء رمز». - اختر مجموعة من قائمة «اختيار المجموعة». تحدد المجموعة النماذج المتاحة ومضاعف الفوترة ومسار الاتصال بالخدمة upstream. المجموعة
defaultوالمجموعةsvipلهما الأسعار الرسمية نفسها، أماCodexReverseفتستخدم موارد الهندسة العكسية. - معيار التحقق: بعد الحفظ، يظهر في قائمة الرموز مفتاح يبدأ بـ
sk-. - إذا واجهت مشكلة: «المجموعة» على مستوى المستخدم ليست هي مجموعة الرمز. المجموعة التي تحدد الإعداد الفعلي هي المجموعة المختارة للرمز.
الخطوة 3: اعثر على Base URL
يختلف Base URL بحسب حزمة SDK، وهذا أكثر موضع يسهل إدخال قيمة خاطئة فيه:
- حزمة OpenAI SDK:
https://api.apiyi.com/v1، ويجب أن يتضمن المسار/v1. - حزمة Anthropic SDK: استخدم النطاق الأساسي من دون
/v1. - حزمة Google GenAI SDK: استخدم النطاق الأساسي، واضبط
api_versionعلىv1beta.
معيار التحقق: استخدم سلسلة GPT-6.1 حزمة OpenAI SDK أو عميلًا متوافقًا مع OpenAI، وتأكد من أن العنوان الذي أدخلته ينتهي بـ /v1. إذا واجهت مشكلة: إذا ظهر الخطأ 404، فغالبًا ما يكون السبب نسيان /v1 أو كتابته مرتين.
الخطوة 4: أدخل اسم النموذج
أدخل معرّف النموذج في حقل النموذج ضمن العميل أو أداة تصحيح الأخطاء. يُنصح بالبدء بنموذج خفيف مثل gpt-5.4-mini للتأكد من عمل التكامل، ثم الانتقال إلى gpt-6.1-sol. وعندما يصبح gpt-6.1-terra متاحًا على المنصة، لن تحتاج إلا إلى تغيير حقل واحد. لا تدعم المنصة صيغ التوجيه المجانية مثل auto وauto:free، لذا لا تحاول استخدامها.
معيار القبول: يجب أن يطابق اسم النموذج طريقة كتابته في قائمة النماذج على المنصة حرفيًا. إذا واجهت مشكلة: إذا ظهرت رسالة تفيد بأن النموذج غير موجود، فتحقق أولًا من تهجئته في قائمة النماذج، ثم تأكد من أن مجموعة الرموز المميزة تشمل هذا النموذج.
الخطوة 5: تنفيذ أول طلب
إليك أبسط مثال عملي، في خمس خطوات:
- اضبط متغير البيئة:
export OPENAI_API_KEY=sk-你的令牌 - أنشئ العميل:
client = OpenAI(base_url="https://api.apiyi.com/v1")، وسيُقرأ المفتاح تلقائيًا من متغير البيئة. - استخدام Responses:
r = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己", reasoning={"effort": "low"}, max_output_tokens=800) - استخدام Chat:
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "简洁回答"}, {"role": "user", "content": "你好"}], max_completion_tokens=800) - اطبع النتائج للتحقق:
print(c.model, c.usage.prompt_tokens)
معيار القبول: يجب أن يُرجع الطلب HTTP 200، وأن يحتوي usage.prompt_tokens على قيمة رقمية (في Responses، تحقّق من usage.input_tokens). بعد تغيير النموذج إلى gpt-6.1-terra، يجب أن يُظهر حقل model في الاستجابة اسم هذا النموذج.
🚀 بدء سريع: ننصحك بتجربة
gpt-6.1-solأولًا باستخدام الرصيد التجريبي على APIYI apiyi.com، للتأكد من صحة المفتاح والمجموعة وعنوان Base URL. بعد إتاحة Terra، يكفي تغيير اسم النموذج للتبديل إليه. يُرجى الرجوع إلى قائمة النماذج على المنصة لمعرفة النماذج والأسعار.
| الخطوة | الإجراء في لوحة التحكم | معيار القبول | ما يجب التحقق منه أولًا عند التعثر |
|---|---|---|---|
| 1 التسجيل | سجّل حسابًا بنفسك ثم سجّل الدخول | ظهور رصيد تجريبي قدره 0.05 دولار | اكتمال خطوات التسجيل |
| 2 المفتاح | أنشئ مفتاحًا واختر مجموعة | ظهور مفتاح يبدأ بـ sk- في القائمة |
عدم الخلط بين مجموعة المفتاح ومجموعة المستخدم |
| 3 Base URL | أدخل في OpenAI SDK عنوانًا ينتهي بـ /v1 |
انتهاء العنوان بـ /v1 |
تحقّق من وجود /v1 عند ظهور الخطأ 404 |
| 4 اسم النموذج | أدخل اسمًا مثل gpt-6.1-sol |
مطابقته تمامًا للاسم في قائمة النماذج | الإملاء والنماذج المتاحة للمجموعة |
| 5 الطلب | أرسل أول استدعاء | ظهور استجابة 200 ووجود قيمة رقمية في usage | رمز الحالة ونص الاستجابة وx-request-id |
يمكنك أيضًا استخدام Magpie لتسهيل عملية الربط. أدخل المفتاح وعنوان Base URL في الواجهة الرسومية، وسيتولى Magpie ربط أدوات الوكلاء البرمجية مثل Claude Code وCodex وPi وHermes بالبوابة نفسها تلقائيًا، دون الحاجة إلى تعديل ملفات الإعدادات واحدًا تلو الآخر.
اختيار نقطة نهاية API لـ GPT-6.1 Terra: مقارنة بين Responses وChat Completions
| بند المقارنة | Responses (v1/responses) | Chat Completions (v1/chat/completions) |
|---|---|---|
| استدعاء الأدوات | مدعوم، مع إمكانية إرفاق 10 فئات من الأدوات المضمّنة | غير مدعوم؛ ستفشل الطلبات التي تتضمن tools |
| تعليمات النظام | instructions |
دور developer ضمن messages، وهو أكثر استقرارًا من system |
| مستوى الاستدلال | reasoning: {effort: ...} |
reasoning_effort |
| الحد الأقصى للإخراج | max_output_tokens |
max_completion_tokens |
| تنسيق الإدخال | سلسلة نصية أو مصفوفة رسائل، وتُستخدم input_image للصور | مصفوفة messages |
| استكمال المحادثات متعددة الجولات | include: ["reasoning.encrypted_content"]، مع تمرير output للجولة السابقة كما هو |
تجميع سجل الرسائل يدويًا |
| بيانات الاستخدام في البث | تُعاد افتراضيًا | يلزم إضافة stream_options: {include_usage: true} |
تحليل مقارن لـ Chat Completions: يتميز Chat بالتوافق مع الشفرة القديمة؛ إذ يمكن تشغيل معظم المشاريع بمجرد تغيير اسم النموذج. لكنه لا يدعم استدعاء الأدوات على Terra، كما أن بعض المجموعات قد تتجاهل رسالة system. في المقابل، يدعم Responses الأدوات واستكمال الاستدلال المشفّر بشكل أصيل، ما يجعله أنسب لبناء الوكلاء وسيناريوهات الاستدلال متعدد الجولات.
يتوفر مستوى الاستدلال في ست درجات: none وlow وmedium (الافتراضي) وhigh وxhigh وmax، ولا توجد درجة minimal. تُحتسب رموز الاستدلال ضمن تكلفة الإخراج والحد الأقصى له؛ لذا اترك هامشًا في max_output_tokens، وإلا فقد يُقتطع الإخراج قبل انتهاء الاستدلال.
ثلاثة أخطاء شائعة في معلمات GPT-6.1 Terra API
| الخطأ الشائع | الصيغة الخاطئة | الصيغة الصحيحة | النتيجة |
|---|---|---|---|
| استخدام tools مع Chat | تمرير tools إلى chat.completions | استخدام نقطة نهاية Responses | فشل الطلب |
| استخدام معلمة قديمة | تمرير max_tokens إلى Chat |
تغييره إلى max_completion_tokens |
400 |
| تعارض معلمات أخذ العينات | تمرير temperature أو top_p عندما لا تكون قيمة effort هي none | حذف temperature وtop_p وtop_logprobs، وحذف logprobs أيضًا عند استخدام Chat | 400 |
إضافةً إلى هذه الأخطاء الثلاثة، تذكر الوثائق الرسمية حالات أخرى قد تؤدي إلى استجابة 400: ضبط effort على minimal، أو تمرير قيمة غير صالحة إلى prompt_cache_options.ttl، أو تجاوز الإدخال 922,000 رمز. يجب أن يكون رابط الصورة قابلًا للتنزيل من الخادم؛ فقد تفشل المواقع التي تستخدم آليات مكافحة الزحف. في هذه الحالة، يكون استخدام عنوان URL لبيانات base64 أكثر موثوقية.
عند استكشاف الأخطاء وإصلاحها، تذكّر أمرًا مهمًا: يظهر نص الخطأ الأصلي مرة واحدة فقط في متن الاستجابة. أما سجلات النظام الخلفية فهي سجل الفوترة، ولا تُسجّل فيها الاستدعاءات الفاشلة. لذا احتفظ برمز حالة HTTP، ونص الاستجابة الأصلي كاملًا، وقيمة x-request-id الواردة في ترويسة الاستجابة. لا تستدعِ raise_for_status() قبل قراءة المتن، وإلا ستفقد تفاصيل الخطأ.
أسعار GPT-6.1 Terra API وشرائح 272K
فيما يلي الأسعار الرسمية بالدولار لكل مليون token. انتبه إلى أن الشريحة تُحدَّد على مستوى الطلب بالكامل: إذا تجاوز حجم الإدخال 272K، تُحتسب جميع بنود الفوترة في الطلب وفق الشريحة الثانية.
| بند الفوترة | الإدخال ≤ 272K | الإدخال > 272K |
|---|---|---|
| الإدخال | 1 | 2 |
| الإخراج (بما في ذلك token الاستدلال) | 5 | 7.5 |
| قراءة الذاكرة المؤقتة | 0.05 | 0.1 |
| الكتابة إلى الذاكرة المؤقتة (30 دقيقة) | 1.25 | 2.5 |
| الكتابة إلى الذاكرة المؤقتة (12 ساعة) | 2.50 | 5 |
عند تقدير التكلفة، احسب البنود الأربعة كلها: الإدخال، والإخراج، وقراءة الذاكرة المؤقتة، والكتابة إليها. ويجب أيضًا التمييز بين مدتي الكتابة: 30 دقيقة و12 ساعة. فالاعتماد على سعري الإدخال والإخراج وحدهما يؤدي إلى تقدير أقل من التكلفة الفعلية في حالات السياق الطويل واستخدام الذاكرة المؤقتة. أسعار النماذج من الجيل نفسه المتاحة على المنصة مطابقة للأسعار الرسمية في بنود الفوترة الأربعة، وتُطبَّق عليها أيضًا الشرائح بحسب الطلب بالكامل.
حدود معدل الطلبات في فئة Standard الرسمية هي: Build بمعدل 5,000 RPM / 1 مليون TPM، وLaunch بمعدل 10,000 RPM / 4 ملايين TPM، وGrow بمعدل 15,000 RPM / 40 مليون TPM.
💰 نصيحة لتقليل التكلفة: حاول إبقاء حجم الإدخال في كل طلب دون 272K عند معالجة المستندات الطويلة، واستخدم التخزين المؤقت للموجهات؛ فهذا يساعد على خفض السعر بوضوح. يمكنك اختيار مجموعة
defaultأوsvipعبر APIYI apiyi.com للاستفادة من أسعار مماثلة للأسعار الرسمية. يُرجى الرجوع إلى قائمة النماذج على المنصة لمعرفة النماذج والأسعار المحددة.
تنبيه أمني بشأن GPT-6.1 Terra API
احفظ مفتاح API في متغيرات البيئة أو في خدمة لإدارة الأسرار، ولا تضعه مباشرةً في الشفرة المصدرية، ولا ترفعه إلى مستودع Git. يُنصح باستبعاد ملفات .env في .gitignore. إذا تسرّب المفتاح، فاحذفه فورًا من صفحة الرموز وأنشئ رمزًا جديدًا. واحرص على اختيار المجموعة المناسبة للرمز: فقد يؤدي اختيار مجموعة خاطئة، في أفضل الأحوال، إلى ظهور خطأ يفيد بأن النموذج غير متاح، وفي أسوأها إلى احتساب الرسوم بمضاعف غير متوقع. ويُفضّل استخدام رمز مختلف لكل مشروع، لتسهيل التحكم في الحصص وتعطيل الرموز كلٌّ على حدة.
الأسئلة الشائعة
س1: ما GPT-6.1 Terra؟
هو نموذج أطلقته OpenAI في 2026-10-26، ومعرّفه `gpt-6.1-terra`. يبلغ طول نافذة السياق 1,050,000، ويدعم النصوص والصور كمدخلات، والنصوص كمخرجات. ويمكن استدعاؤه عبر ثلاث نقاط نهاية: Responses وChat Completions وBatch.
س2: متى أختار Responses ومتى أختار Chat Completions في GPT-6.1 Terra؟
اختر Responses إذا كنت تحتاج إلى استدعاء الأدوات، مثل function calling أو web_search. أما للمحادثات العادية، فيمكنك استخدام Chat، لكن عليك استخدام max_completion_tokens بدلًا من ذلك، ولا يمكنك تضمين tools.
س3: هل يمكن استدعاء gpt-6.1-terra عبر APIYI الآن؟
حتى 2026-10-27، لم يُدرج النموذج في المنصة بعد، وسنعمل على توفيره في أقرب وقت. يمكنك مؤقتًا استخدام `gpt-6.1-sol` من الجيل نفسه على APIYI apiyi.com للتحقق من تكامل الاتصال. يُرجى الرجوع إلى قائمة النماذج في المنصة لمعرفة المعرّفات والأسعار.
س4: لماذا يظهر خطأ 400 عند تمرير temperature؟
عندما لا تكون قوة الاستدلال none، لا يمكن تمرير temperature أو top_p أو top_logprobs. احذف هذه المعلمات، أو اضبط effort على none.
س5: هل يمكنني إجراء اختبار من دون شحن الرصيد؟
نعم. يحصل الحساب الجديد المسجّل في APIYI apiyi.com على رصيد تجريبي بقيمة 0.05 دولار، وهو كافٍ لإجراء استدعاء بسيط والتحقق من الاتصال. يُنصح بتجربة `gpt-5.4-mini` أولًا، ثم الانتقال إلى النموذج المطلوب.
س6: ما القيود المعروفة في GPT-6.1 Terra؟
لا يدعم الضبط الدقيق fine-tuning أو المخرجات المتوقعة predicted outputs، كما لا يدعم نقاط النهاية Realtime وAssistants وEmbeddings وImages وAudio وغيرها. إذا تجاوز الإدخال 272K، فستُحتسب تكلفة الطلب بالكامل وفق الشريحة الثانية. وإذا تجاوز 922,000 tokens، فسيظهر خطأ 400 مباشرةً.
أهم النقاط حول واجهة GPT-6.1 Terra API
- القرار الأساسي الوحيد: إذا كنت تحتاج إلى الأدوات، فاستخدم Responses؛ وإلا، يكفي تغيير اسم النموذج في Chat.
- ثلاثة أخطاء شائعة في المعلمات: لا تُضمّن
toolsفي Chat، واستخدمmax_completion_tokens، ولا تمرّر معلمات أخذ العينات عندما تكون قيمةeffortغيرnone. - خمس خطوات في لوحة التحكم: سجّل، وأنشئ رمزًا واختر المجموعة، وأضف
/v1إلى Base URL، وأدخل اسم النموذج، ثم أرسل طلبًا. - علامات نجاح التحقق: يبدأ المفتاح بـ
sk-، ويُرجع الطلب الحالة 200 وتتضمنusageأرقامًا، ويُعاد اسم النموذج في حقلmodel. - عناصر التسعير الأربعة: الإدخال، والإخراج، وقراءة الذاكرة المؤقتة، والكتابة إليها. إذا تجاوزت الكمية 272K، تُحتسب الفاتورة كاملة وفق الشريحة الثانية.
- طريقة البدء: اختبر تدفق العمل أولًا باستخدام
gpt-6.1-solعبر APIYI؛ وبعد إتاحة Terra، لن تحتاج إلا إلى تغيير اسم النموذج.
الخلاصة
يمكن تلخيص أهم النقاط عند إعداد GPT-6.1 Terra API في ثلاثة أمور:
- ابدأ بتحديد نقطة النهاية: اختر أولًا بين Responses وChat، فهذا يحدد طريقة كتابة المعلمات وإمكانية استخدام الأدوات.
- تحقق خطوة بخطوة: توجد علامة واضحة للتحقق في كل مرحلة، من الرمز وBase URL إلى اسم النموذج والطلب الأول.
- قدّر التكلفة مسبقًا: تُطبّق شريحة 272K على الطلب كاملًا، لذا احسب تكاليف العناصر الأربعة للذاكرة المؤقتة ضمن ميزانيتك.
نوصي باختبار تدفق العمل كاملًا أولًا باستخدام gpt-6.1-sol عبر APIYI على apiyi.com. وحتى 2026-10-27، لم تُدرج المنصة بعد gpt-6.1-terra، وسنعمل على إتاحته في أقرب وقت. يُرجى الرجوع إلى قائمة النماذج في المنصة لمعرفة الطرازات والأسعار.
📚 مراجع
- صفحة نموذج OpenAI – GPT-6.1 Terra: مواصفات النموذج ونقاط النهاية المدعومة
- الرابط:
platform.openai.com/docs/models/gpt-6.1-terra -
الوصف: المعلومات الرسمية حول السياق والوسائط والأدوات المتاحة
-
أحدث دليل نماذج OpenAI: ترحيل المَعلمات والقيود
- الرابط:
platform.openai.com/docs/guides/latest-model -
الوصف: قواعد المَعلمات مثل reasoning.effort وmax_completion_tokens
-
صفحة أسعار OpenAI: التسعير المتدرّج وأسعار التخزين المؤقت
- الرابط:
platform.openai.com/docs/pricing - الوصف: التسعير على مستويين عند 272K وأسعار مدة كتابة البيانات في التخزين المؤقت
المؤلف: فريق APIYI التقني
للتواصل التقني: يسعدنا تواصلكم معنا عبر الصفحة الرئيسية لموقع APIYI. ويمكنكم الاطلاع على مزيد من إرشادات التكامل في مركز الوثائق على docs.apiyi.com
