GPT API: استخدام نماذج GPT-6 في برمجياتك
يصل المطورون إلى نماذج GPT عبر واجهة برمجة OpenAI أو عبر خدمات مثل OpenRouter. يوضح هذا الدليل الطلب البرمجي الأول، ومعرّفات النماذج، وإعدادات التفكير المنطقي، وتكلفة كل نموذج.

طريقتان لاستدعاء GPT برمجياً من كودك
إذا أردت دمج GPT داخل تطبيقك، أو في سكربت، أو جدول بيانات، فستحتاج إلى الوصول عبر واجهة برمجة التطبيقات (API). هناك طريقان شائعان:
- واجهة OpenAI API عبر
https://api.openai.com/v1. تقوم بالتسجيل في منصة OpenAI، وإضافة بيانات الدفع، وإنشاء مفتاح API، ثم استدعاء نماذج مثلgpt-6-lunaأوgpt-6.1-terraمباشرةً. - منصة OpenRouter عبر
https://openrouter.ai/api/v1. مفتاح واحد يتيح لك استخدام GPT إلى جانب نماذج من شركات أخرى، وبنفس بنية الطلب للجميع. تبدأ معرفات نماذج GPT ببادئةopenai/، مثلopenai/gpt-6-luna.
تعتمد كلتا الخدمتين على التسعير لكل رمز (token)، وهي الأجزاء النصية الصغيرة التي يقرؤها النموذج ويكتبها. يتم تسعير المدخلات (البرومبت) والمخرجات (الإجابة) بشكل منفصل، ودائماً ما تكون المخرجات هي الأعلى سعراً. كما تُحسب رموز التفكير (العمليات الحسابية والذهنية الخفية التي يجريها النموذج قبل الرد) ضمن المخرجات أيضاً.
ملاحظة سريعة قبل البدء: لا يقدّم موقع GPT.me واجهة API عامة. موقعنا مخصص للدردشة المباشرة للمستخدمين. للاستخدام البرمجي، اعتمد على أحد المسارين المذكورين أعلاه.
أسعار GPT الحالية
الأسعار لكل مليون رمز لنماذج GPT-6 الحالية، وفقاً لقائمة OpenRouter؛ وتعتمد واجهة OpenAI API نفس الأسعار الأساسية.
| النموذج | معرف API (OpenAI) | المدخلات | المدخلات المخزنة مؤقتاً (Cached) | المخرجات |
|---|---|---|---|---|
| GPT-6 Luna | gpt-6-luna | 0.10$ | 0.01$ | 0.50$ |
| GPT-6.1 Terra | gpt-6.1-terra | 1$ | 0.05$ | 5$ |
| GPT-6 Sol | gpt-6-sol | 2$ | 0.20$ | 10$ |
| GPT-6.1 Sol | gpt-6.1-sol | 2$ | 0.10$ | 10$ |
| GPT-6 Astra | gpt-6-astra | 10$ | 1$ | 50$ |
أسعار قائمة OpenRouter لشهر نوفمبر 2026. تقبل النماذج الخمسة جميعها النصوص والصور، وتعيد مخرجات نصية، وتمتلك نافذة سياق تتسع لـ 1,050,000 رمز مع مخرجات تصل إلى 128,000 رمز. عندما يتجاوز طلب واحد حاجز 272,000 رمز، تُضاعف أسعار OpenRouter تكلفة المدخلات وتزيد سعر المخرجات بمقدار النصف لهذا الطلب. توفر OpenRouter أيضاً إصدارات "pro" من كل نموذج، والتي تعمل في وضع يستهلك عدداً أكبر بكثير من رموز التفكير.
استدعاء OpenAI مباشرةً
توفر OpenAI نقطتي نهاية (endpoints) للنصوص: واجهة Responses API الأحدث، والمستخدمة بالكامل في وثائق GPT-6 الرسمية، ونقطة Chat Completions الأقدم، والتي لا تزال تعمل مع المحادثات البسيطة. أنشئ مفتاحاً على المنصة، واحفظه في متغير بيئة باسم OPENAI_API_KEY، ثم أرسل الطلب. باستخدام curl:
curl https://api.openai.com/v1/responses \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-luna",
"reasoning": { "effort": "none" },
"input": "اذكر ثلاثة استخدامات لمشبك الورق، كل استخدام في سطر."
}'
تأتي الإجابة بصيغة JSON؛ ويوجد النص المولد داخل مصفوفة output. تستخرج لك مكتبة Python الرسمية الرد مباشرةً:
from openai import OpenAI
client = OpenAI() # يقرأ OPENAI_API_KEY تلقائياً
result = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "low"},
input="هل 391 عدد أولي؟ اشرح في جملتين.",
)
print(result.output_text)
يمكنك تثبيتها عبر الأمر pip install openai. تتوفر المكتبة نفسها أيضاً للغة JavaScript وعدة لغات أخرى.
استدعاء GPT عبر OpenRouter
تدعم OpenRouter صيغة Chat Completions، لذا فإن معظم الأكواد المتوافقة مع OpenAI ستعمل مباشرة بمجرد تعديل عنوان الخدمة والمفتاح ومعرف النموذج. يغطي دليل البدء السريع كافة التفاصيل. إليك مثالاً بلغة JavaScript الخالصة دون أي مكتبات إضافية:
const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";
const payload = {
model: "openai/gpt-6-luna",
max_tokens: 800,
reasoning: { effort: "low" },
messages: [
{ role: "system", content: "أجب باختصار ووضوح." },
{ role: "user", content: "ما الفرق بين ذاكرة الوصول العشوائي (RAM) وذاكرة التخزين؟" },
],
};
const key = process.env.OPENROUTER_API_KEY;
const res = await fetch(OPENROUTER_URL, {
method: "POST",
body: JSON.stringify(payload),
headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
});
const body = await res.json();
const text = body.choices?.[0]?.message?.content;
console.log(text ?? body);
قم بتشغيل الكود باستخدام Node 18 أو أحدث (حيث يحتوي على fetch بشكل مدمج)، واحفظه كملف .mjs ليعمل await مباشرة في النطاق العام. في حال عدم إرجاع أي نص، سيطبع السكربت الاستجابة كاملة: حيث تُرجع OpenRouter حقلاً باسم error يحتوي على رسالة توضيحية، كما في حالات المفتاح غير الصحيح أو نفاد الرصيد.
تعرض صفحات النماذج على OpenRouter، مثل GPT-6 Luna وGPT-6.1 Terra، الأسعار الحالية والمزودين والمعلمات (parameters) المدعومة.
إعدادات شائعة تسبب المشاكل
- جهد التفكير (Reasoning effort). تقبل نماذج GPT-6 Luna وGPT-6 Sol وGPT-6.1 Terra القيم:
noneوlowوmediumوhighوxhighوmax، وتعتمدmediumكقيمة افتراضية على OpenRouter. أما GPT-6.1 Sol وGPT-6 Astra فهما يفكران دائماً ولا يمكن ضبطهما علىnone. في واجهة Responses API يكون الحقلreasoning.effort؛ أما في Chat Completions فهوreasoning_effort. - الحرارة (Temperature). يوضح دليل OpenAI أن معلمات
temperatureوtop_pغير مدعومة أثناء تفعيل وضع التفكير، لذا احذفهما إلا إذا كان الجهد مضبوطاً علىnone. قد تفشل الأكواد القديمة التي تحدد درجة الحرارة وتظهر رسالة خطأ. - حد المخرجات الأقصى. تستهلك عمليات التفكير جزءاً من حصة الرموز المحددة. إذا قمت بضبط قيمة
max_tokensمنخفضة مع جهد تفكير عالٍ، فقد تنفد الرموز من النموذج قبل أن يكتب الإجابة المرئية. - الأدوات (Tools). تشير صفحات نماذج OpenAI إلى أن استدعاء الدوال (function calling) لنموذج GPT-6.1 Terra يتطلب واجهة Responses API. إذا لاحظت سلوكاً غير متوقع للأدوات عبر Chat Completions، فقم بالانتقال إلى النقطة الأحدث.
كيف تحافظ على فاتورة منخفضة
- ابدأ بنموذج Luna. بسعر يعادل عُشر تكلفة Terra، يؤدي Luna مهام التلخيص، والاستخراج، والتصنيف، والردود القصيرة بكفاءة ممتازة. لا تنتقل إلى نماذج أعلى إلا للمهام التي يتعثر فيها.
- أبقِ جهد التفكير منخفضاً. كل مستوى إضافي في جهد التفكير يعني عادةً استهلاك المزيد من الرموز الخفية للمخرجات. استخدم
noneأوlowللمهام البسيطة. - أعد استخدام البادئة الثابتة (Prefix). تكلفة المدخلات المخزنة مؤقتاً (Cached) تعادل عُشر تكلفة المدخلات الجديدة أو أقل. ضع التعليمات الطويلة والثابتة في بداية كل برومبت حتى تستفيد الطلبات المتكررة من الذاكرة المؤقتة.
- ابقَ تحت 272,000 رمز في الطلب الواحد قدر الإمكان، لتجنب الرسوم الإضافية للسياق الطويل.
- عيّن حداً أقصى للإنفاق في لوحة تحكم حسابك حتى لا تتسبب أي حلقة برمجية لا نهائية (loop) في رفع الفاتورة فجأة.
- قلّص سجل المحادثة المُرسل. يُحسب كل طلب بناءً على حجم المحادثة بالكامل مجدداً. احتفظ فقط بالردود التي يحتاجها النموذج، أو استبدل المحادثات القديمة بملخص موجز.
طريقة تقريبية لحساب التكلفة: الرمز الواحد يعادل تقريباً ثلاثة أرباع كلمة إنجليزية. سؤال وجواب بحجم بضع مئات من الكلمات لكل منهما يستهلكان قرابة 1000 رمز إجمالاً، وبالتالي تكون تكلفة الطلب هي السعر لكل مليون من الجدول مقسوماً على 1000، مضافاً إليه أي رموز تفكير. راقب حقل usage في كل استجابة للاطلاع على الأرقام الدقيقة لطلباتك.
للحصول على مساعدة برمجية أوسع، راجع دليلنا حول استخدام GPT للبرمجة وصفحة المطورين. ولاختبار أي برومبت قبل كتابة الكود، جرّبه أولاً في محادثة GPT-6 Luna لدينا.
الأسئلة الشائعة
هل واجهة GPT API مجانية؟
لا. تعتمد كل من OpenAI وOpenRouter على الدفع مقابل الاستخدام لكل رمز. الاختبار البسيط لنموذج GPT-6 Luna يكلف جزءاً ضئيلاً جداً من السنت، لكنك لا تزال بحاجة إلى حساب مفعل ببيانات دفع.
هل أستخدم OpenAI مباشرة أم OpenRouter؟
اختر OpenAI مباشرة إذا كنت تستخدم GPT فقط وتريد الحصول على أحدث ميزات OpenAI أولاً بأول. واختر OpenRouter إذا كنت تريد التنقل بسهولة بين GPT وClaude وGemini ونماذج أخرى بمفتاح واحد وفاتورة موحدة.
بأي نموذج تنصحني أن أبدأ؟
ابدأ مع GPT-6 Luna للسرعة والتكلفة الاقتصادية، وGPT-6.1 Terra لجودة صياغة أفضل وفهم أقوى للصور ومهام التفكير المعقدة، واحتفظ بـ GPT-6.1 Sol أو GPT-6 Astra لأصعب التحديات البرمجية والتحليلية المتقدمة.
هل يوفر GPT.me واجهة API؟
لا. موقع GPT.me مخصص للدردشة المجانية المباشرة عبر الويب. للاستخدام البرمجي المؤتمت، استخدم واجهة OpenAI API أو منصة OpenRouter.
لديك سؤال؟ اطرحه الآن
دون حساب ودون تنزيل أي برامج. افتح المحادثة، واكتب ما يدور في ذهنك، وستبدأ الإجابة في الظهور خلال ثانية أو ثانيتين.
ابدأ المحادثة

