TL;DR / إجابة سريعة
للوصول إلى واجهة برمجة تطبيقات GPT-5.4: (1) أنشئ حساب OpenAI على platform.openai.com، (2) أضف طريقة دفع في إعدادات الفواتير، (3) أنشئ مفتاح API من قسم مفاتيح API، (4) ثبت حزمة OpenAI SDK (pip install openai أو npm install openai)، (5) عيِّن متغير البيئة OPENAI_API_KEY، (6) قدم طلبات إلى نموذج gpt-5.4. التسعير: 2.50 دولار لكل مليون رمز إدخال، 15 دولارًا لكل مليون رمز إخراج. يتوفر الإصدار الاحترافي (30 دولارًا / 180 دولارًا) للمهام المعقدة.
مقدمة
يستغرق الوصول إلى واجهة برمجة تطبيقات GPT-5.4 حوالي 10 دقائق من إنشاء الحساب حتى أول استدعاء لواجهة برمجة التطبيقات. لكن عملية الإعداد تتضمن عدة خطوات حيث تخلق فجوات التوثيق احتكاكًا: التحقق من الفواتير، إدارة مفتاح API، تثبيت SDK، وفهم مستويات التسعير.
يشرح هذا الدليل كل خطوة بالصور وأمثلة التعليمات البرمجية ونصائح استكشاف الأخطاء وإصلاحها. ستتعلم كيفية إعداد حساب OpenAI الخاص بك، وإنشاء مفاتيح API بشكل آمن، وتثبيت SDK، والبدء في تقديم الطلبات إلى GPT-5.4.
سنغطي أيضًا تفاصيل التسعير، وحدود المعدل، والوصول الخاص بالمنصة (ChatGPT مقابل Codex مقابل API)، وأفضل ممارسات الأمان لعمليات النشر في الإنتاج.
ما ستحصل عليه:
- إعداد الحساب خطوة بخطوة مع إعداد الفواتير
- إنشاء مفتاح API وتخزينه بشكل آمن
- تثبيت SDK لـ Python و Node.js و cURL
- أمثلة على طلبات API الأولى مع الاستجابات المتوقعة
- تفصيل كامل للتسعير ونصائح تحسين التكلفة
- معلومات عن حدود المعدل وإدارة الحصص
المتطلبات الأساسية
قبل البدء، تأكد من توفر لديك:
- عنوان بريد إلكتروني - لإنشاء حساب OpenAI
- طريقة دفع - بطاقة ائتمان/خصم (Visa, Mastercard, Amex)
- رقم هاتف - للتحقق من الحساب
- بيئة تطوير - Python 3.7+، Node.js 14+، أو cURL
- محرر نصوص أو بيئة تطوير متكاملة (IDE) - VS Code، Cursor، أو ما شابه
الوقت المطلوب: 10-15 دقيقة التكلفة: 0 دولار للبدء (تسعير الدفع حسب الاستخدام)
الخطوة 1: إنشاء حساب OpenAI
انتقل إلى platform.openai.com وانقر على "تسجيل الدخول".
ستحتاج إلى توفير:
- عنوان البريد الإلكتروني
- كلمة المرور (8 أحرف كحد أدنى)
- الاسم الكامل
- رقم الهاتف للتحقق
يرسل OpenAI رمز تحقق إلى بريدك الإلكتروني. أدخل الرمز للتحقق من حسابك.

هام: استخدم بريدًا إلكترونيًا تجاريًا إذا كنت تخطط لاستخدام واجهة برمجة التطبيقات (API) للمشاريع التجارية. تتطلب عمليات نقل ملكية الحساب تذاكر دعم.
بعد التحقق من البريد الإلكتروني، أكمل التحقق من الهاتف:
- اختر رمز بلدك
- أدخل رقم هاتفك
- استقبل رسالة SMS تحتوي على رمز التحقق
- أدخل الرمز لإكمال التحقق
قد تكون بعض المناطق لديها وصول محدود إلى واجهة برمجة التطبيقات (API). تحقق من قائمة الدول المدعومة من OpenAI إذا واجهت مشاكل.
الخطوة 2: إعداد الفواتير
تستخدم واجهة برمجة تطبيقات GPT-5.4 تسعير الدفع حسب الاستخدام. يجب عليك إضافة طريقة دفع قبل تقديم الطلبات.
انتقل إلى الإعدادات > الفواتير في لوحة تحكم المنصة.
إضافة طريقة دفع
- انقر على "إضافة طريقة دفع"
- أدخل تفاصيل بطاقة الائتمان/الخصم (Visa أو Mastercard أو American Express)
- يجب أن يتطابق عنوان الفاتورة مع تسجيل البطاقة
- انقر على "حفظ"

تجري OpenAI رسوم تفويض صغيرة (0.50-1.00 دولار) للتحقق من البطاقة. تُعكس هذه الرسوم في غضون 3-5 أيام عمل.
مستويات الفوترة
تبدأ حسابات OpenAI بحدود المستوى الافتراضي:
المستوى 1 (الحسابات الجديدة):
- رصيد أولي قدره 5 دولارات (ينتهي بعد 3 أشهر)
- حد الاستخدام: 5 دولارات شهريًا
- يتطلب التحقق من البطاقة
المستوى 2 (بعد الدفعة الأولى):
- حد الاستخدام: 120 دولارًا شهريًا
- تلقائي بعد دورة فوترة ناجحة
المستوى 3 (حجم كبير تم التحقق منه):
- حدود مخصصة
- يتطلب الاتصال بفريق المبيعات
لزيادة الحدود:
- انتقل إلى الإعدادات > الفواتير > الحدود
- انقر على "طلب زيادة الحد"
- قدم وصفًا لحالة الاستخدام والمصروفات الشهرية المتوقعة
- انتظر من 1 إلى 3 أيام عمل للموافقة
تمكين تنبيهات الاستخدام
قم بإعداد تنبيهات الفواتير لتجنب الرسوم غير المتوقعة:
- الإعدادات > الفواتير > نظرة عامة
- انقر على "إضافة تنبيه"
- حدد العتبة (على سبيل المثال، 50 دولارًا، 100 دولار، 500 دولار)
- أدخل البريد الإلكتروني للإشعارات
ستتلقى رسائل بريد إلكتروني عندما يتجاوز الاستخدام كل عتبة.
الخطوة 3: إنشاء مفتاح API
مفاتيح API توثق طلباتك إلى واجهة برمجة تطبيقات OpenAI.
انتقل إلى platform.openai.com/api-keys.
إنشاء مفتاح جديد
- انقر على "إنشاء مفتاح سري جديد"
- أدخل اسمًا وصفيًا (على سبيل المثال، "Development", "Production", "CI/CD")
- اختر المشروع (اختياري، لحسابات المؤسسات)
- انقر على "إنشاء مفتاح سري"

مهم للغاية: انسخ المفتاح فورًا. لا يمكنك عرضه مرة أخرى بعد إغلاق النافذة المنبثقة. إذا فقد، قم بإنشاء مفتاح جديد.
صيغة المفتاح: sk-proj- متبوعًا بسلسلة أبجدية رقمية (مثال: sk-proj-abc123def456...)
أذونات المفتاح
تدعم OpenAI أذونات دقيقة:
- جميع القدرات - وصول كامل إلى واجهة برمجة التطبيقات (API) (افتراضي)
- نماذج محددة - تقييد الوصول إلى نماذج مختارة
- نقاط نهاية محددة - تقييد الوصول إلى نقاط نهاية API معينة
للوصول إلى GPT-5.4، تأكد أن المفتاح يحتوي على:
- الوصول إلى نقطة نهاية Chat Completions
- إذن نموذج GPT-5.4
- أي أذونات أدوات مطلوبة (استخدام الكمبيوتر، الرؤية، إلخ)
أفضل ممارسات تدوير المفتاح
قم بتدوير مفاتيح API كل 90 يومًا:
- إنشاء مفتاح جديد
- تحديث التطبيقات بالمفتاح الجديد
- اختبار شامل
- حذف المفتاح القديم من لوحة تحكم OpenAI
استخدم متغيرات البيئة أو أنظمة إدارة الأسرار (AWS Secrets Manager، HashiCorp Vault) لتخزين المفاتيح بشكل آمن.
الخطوة 4: تثبيت OpenAI SDK
توفر OpenAI حزم SDK رسمية لـ Python و Node.js. يمكنك أيضًا استخدام cURL لطلبات HTTP المباشرة.
تثبيت Python
pip install openaiتحقق من التثبيت:
import openai
print(openai.__version__)يتطلب Python 3.7 أو أعلى. للبيئات الافتراضية:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install openaiتثبيت Node.js
npm install openaiتحقق من التثبيت:
const OpenAI = require('openai');
console.log(OpenAI.version);يتطلب Node.js 14 أو أعلى. لـ TypeScript:
npm install --save-dev @types/nodecURL (لا يتطلب تثبيت)
يأتي cURL مثبتًا مسبقًا على معظم الأنظمة. تحقق:
curl --versionاستخدم cURL لاختبار API السريع بدون تبعيات SDK.
الخطوة 5: تهيئة البيئة
قم بتخزين مفتاح API الخاص بك في متغيرات البيئة. لا تقم أبدًا بتضمين المفاتيح بشكل مباشر في الكود المصدري.
لينكس/ماك أو إس
أضف إلى ~/.bashrc، ~/.zshrc، أو ملف تعريف الصدفة:
export OPENAI_API_KEY="sk-proj-abc123def456..."إعادة تحميل الصدفة:
source ~/.zshrc # أو ~/.bashrcويندوز
موجه الأوامر:
set OPENAI_API_KEY=sk-proj-abc123def456...بوويرشيل:
$env:OPENAI_API_KEY="sk-proj-abc123def456..."دائم (متغيرات بيئة النظام):
- ابحث عن "متغيرات البيئة" في قائمة البدء
- انقر على "تعديل متغيرات بيئة النظام"
- انقر على "متغيرات البيئة"
- تحت "متغيرات المستخدم"، انقر على "جديد"
- الاسم:
OPENAI_API_KEY - القيمة: مفتاح API الخاص بك
- أعد تشغيل الطرفية
ملف .env (للتطوير)
أنشئ ملف .env في جذر المشروع:
OPENAI_API_KEY=sk-proj-abc123def456...تحميل باستخدام python-dotenv:
pip install python-dotenvfrom dotenv import load_dotenv
load_dotenv()لا تقم أبدًا بتضمين ملفات .env في التحكم بالإصدار. أضف إلى .gitignore:
.envالخطوة 6: تقديم طلبك الأول
اختبر إعداداتك بطلب GPT-5.4 بسيط.
استخدام Apidog لاختبار API: بدلاً من كتابة التعليمات البرمجية لاختبار دمج GPT-5.4 API الخاص بك، استخدم الواجهة المرئية لـ Apidog من أجل:
- تهيئة الطلبات بالرؤوس، والمصادقة، ومعلمات الجسم
- حفظ الطلبات إلى مجموعات للاختبار المتكرر
- استخدام متغيرات البيئة لمفاتيح API عبر بيئات التطوير/التجهيز/الإنتاج
- إنشاء نصوص قبل الطلب لتوليد الرمز المميز ديناميكيًا
- إضافة تأكيدات اختبار للتحقق من بنية ومحتوى الاستجابة
- إنشاء مقتطفات رمز cURL أو Python أو Node.js من الطلبات العاملة
مثال بايثون
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("OPENAI_API_KEY")
)
response = client.chat.completions.create(
model="gpt-5.4",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is GPT-5.4?"}
]
)
print(response.choices[0].message.content)مثال Node.js
const OpenAI = require('openai');
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY
});
async function main() {
const response = await client.chat.completions.create({
model: 'gpt-5.4',
messages: [
{ role: 'system', content: 'You are a helpful assistant.' },
{ role: 'user', content: 'What is GPT-5.4?' }
]
});
console.log(response.choices[0].message.content);
}
main();مثال cURL
curl https://api.openai.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "What is GPT-5.4?"}
]
}'الاستجابة المتوقعة
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1741234567,
"model": "gpt-5.4",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "GPT-5.4 is OpenAI's most advanced frontier model..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 25,
"completion_tokens": 150,
"total_tokens": 175
}
}التحقق من الوصول إلى GPT-5.4
إذا تلقيت خطأ بخصوص الوصول إلى النموذج:
- تحقق من أن الفواتير نشطة (الإعدادات > الفواتير)
- تحقق من أن مفتاح API لديه الأذونات الصحيحة
- تأكد من استخدام اسم النموذج الدقيق
gpt-5.4 - اتصل بدعم OpenAI إذا استمرت المشكلات
تم إطلاق GPT-5.4 تدريجيًا بدءًا من 5 مارس 2026. قد تواجه بعض الحسابات تأخيرًا في الوصول أثناء عملية الإطلاق.
تسعير واجهة برمجة تطبيقات GPT-5.4
يساعد فهم تسعير GPT-5.4 على تحسين التكاليف وتجنب مفاجآت الفوترة.
التسعير القياسي
المكون | السعر |
|---|---|
رموز الإدخال | 2.50 دولار لكل مليون |
رموز الإدخال المخزنة مؤقتًا | 0.25 دولار لكل مليون |
رموز الإخراج | 15 دولارًا لكل مليون |
التسعير الاحترافي
المكون | السعر |
|---|---|
رموز الإدخال | 30 دولارًا لكل مليون |
رموز الإخراج | 180 دولارًا لكل مليون |
برامج الخصم
المعالجة الدفعية (Batch Processing):
- خصم 50% على الأسعار القياسية
- تتم معالجة الطلبات خلال نافذة زمنية مدتها 24 ساعة
- مثالية لأحمال العمل غير التي تتطلب الوقت الفعلي
المعالجة المرنة (Flex Processing):
- خصم 50% على الأسعار القياسية
- تتم معالجة الطلبات خلال فترات انخفاض الطلب
- تأخير متغير (من دقائق إلى ساعات)
المعالجة ذات الأولوية (Priority Processing):
- ضعف الأسعار القياسية
- تتم معالجة الطلبات قبل قائمة الانتظار القياسية
- أدنى تأخير للتطبيقات الحساسة للوقت
مثال على حساب التكلفة
مثال: معالجة 10,000 استعلام دعم عملاء شهريًا
الافتراضات:
- متوسط الإدخال: 500 رمز لكل استعلام
- متوسط الإخراج: 200 رمز لكل استجابة
- الإجمالي الشهري: 5 مليون رمز إدخال + 2 مليون رمز إخراج
التسعير القياسي:
- الإدخال: 5 مليون × 2.50 دولار/مليون = 12.50 دولار
- الإخراج: 2 مليون × 15 دولار/مليون = 30.00 دولار
- المجموع: 42.50 دولار/شهر
مع تسعير الدفعة (خصم 50%):
- الإدخال: 5 مليون × 1.25 دولار/مليون = 6.25 دولار
- الإخراج: 2 مليون × 7.50 دولار/مليون = 15.00 دولار
- المجموع: 21.25 دولار/شهر
نصائح تحسين التكلفة
- استخدم المدخلات المخزنة مؤقتًا - تكلفة المطالبات المتكررة أقل بنسبة 90% (0.25 دولار مقابل 2.50 دولار)
- حسّن المطالبات - المطالبات الأقصر تعني رموز إدخال أقل
- حدد رموز الإخراج - عيّن معلمة
max_tokensبشكل مناسب - استخدم المعالجة الدفعية - توفير 50% لأحمال العمل غير الفورية
- راقب الاستخدام - أعدّ تنبيهات الفواتير وتتبع استهلاك الرموز
تسعير نافذة السياق
السياق القياسي: 272 ألف رمز (تسعير قياسي) السياق الموسع: يصل إلى 1 مليون رمز (معدل استخدام مضاعف)
الطلبات التي تتجاوز 272 ألف رمز تُحسب بمعدل مضاعف للمعدل العادي:
- الإدخال: 5.00 دولار لكل مليون (بدلاً من 2.50 دولار)
- الإخراج: 30 دولارًا لكل مليون (بدلاً من 15 دولارًا)
حدود المعدل والحصص
تطبق OpenAI حدودًا للمعدل لضمان الاستخدام العادل بين العملاء.
حدود المعدل الافتراضية
تختلف حدود المعدل حسب مستوى الحساب وتاريخ الاستخدام.
المستوى 1 (الحسابات الجديدة):
- الطلبات في الدقيقة (RPM): 20
- الرموز في الدقيقة (TPM): 40,000
- الرموز في اليوم (TPD): 100,000
المستوى 2 (الحسابات القائمة):
- الطلبات في الدقيقة (RPM): 60
- الرموز في الدقيقة (TPM): 150,000
- الرموز في اليوم (TPD): 1,000,000
المستوى 3 (حجم كبير):
- حدود مخصصة بناءً على حالة الاستخدام
- اتصل بالمبيعات لمستويات المؤسسات
رؤوس حدود المعدل
تتضمن استجابات واجهة برمجة التطبيقات (API) معلومات عن حدود المعدل:
x-ratelimit-limit-requests: 60
x-ratelimit-limit-tokens: 150000
x-ratelimit-remaining-requests: 59
x-ratelimit-remaining-tokens: 149500
x-ratelimit-reset-requests: 1s
x-ratelimit-reset-tokens: 200msالتعامل مع حدود المعدل
عند تجاوز حد المعدل، ستتلقى خطأ HTTP 429:
{
"error": {
"message": "Rate limit reached for requests",
"type": "rate_limit_error",
"code": "rate_limit_exceeded"
}
}استراتيجية إعادة المحاولة:
import time
from openai import OpenAI, RateLimitError
client = OpenAI()
def make_request_with_retry(messages, max_retries=3):
for attempt in range(max_retries):
try:
return client.chat.completions.create(
model="gpt-5.4",
messages=messages
)
except RateLimitError as e:
if attempt == max_retries - 1:
raise
wait_time = 2 ** attempt # Exponential backoff
time.sleep(wait_time)أفضل الممارسات:
- نفّذ التراجع الأسي (1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ)
- أضف الاهتزاز (jitter) لمنع ظاهرة "قطيع الرعد"
- ضع الطلبات في قائمة الانتظار خلال فترات حركة المرور العالية
- استخدم Batch API للمعالجة المجمعة
طلب زيادة الحد الأقصى
لزيادة حدود المعدل:
- انتقل إلى الإعدادات > الفواتير > الحدود
- انقر على "طلب زيادة الحد"
قدم:
- وصف حالة الاستخدام
- المصروفات الشهرية المتوقعة
- أنماط حركة المرور القصوى
- معلومات الاتصال الفني
- انتظر من 1 إلى 3 أيام عمل
تعتمد الموافقة على:
- سجل الدفع
- مشروعية حالة الاستخدام
- المتطلبات التقنية
- القدرة الحالية
الوصول عبر المنصات
يتوفر GPT-5.4 عبر منصات OpenAI المتعددة بطرق وصول مختلفة.
الوصول عبر واجهة برمجة التطبيقات (API)
أسماء النماذج:
gpt-5.4- النموذج القياسيgpt-5.4-pro- النموذج الاحترافي
طريقة الوصول:
- REST API عبر SDK أو HTTP
- المصادقة عبر مفتاح API
- تسعير الدفع لكل رمز
الأفضل لـ:
- التطبيقات المخصصة
- تكاملات الإنتاج
- أحمال العمل ذات الحجم الكبير
- ميزات استخدام الأدوات واستخدام الكمبيوتر
الوصول إلى ChatGPT
GPT-5.4 Thinking متاح لـ:
- ChatGPT Plus (20 دولارًا/الشهر)
- ChatGPT Team (25 دولارًا/المستخدم/الشهر)
- ChatGPT Pro (200 دولارًا/الشهر)
GPT-5.4 Pro متاح لـ:
- مشتركي ChatGPT Pro
- مشتركي ChatGPT Enterprise
طريقة الوصول:
- واجهة الويب على chatgpt.com
- تطبيقات الجوال (iOS، Android)
- لا يوجد وصول لواجهة برمجة التطبيقات (API) من واجهة ChatGPT
الأفضل لـ:
- الإنتاجية الفردية
- الاستفسارات المخصصة
- المستخدمين غير التقنيين
- الميزات الخاصة بـ ChatGPT (الإدخال الصوتي، الصور)
الوصول إلى Codex
GPT-5.4 هو النموذج الافتراضي في Codex مع:
- نافذة سياق تجريبية بحجم 1 مليون
- مهارة Playwright Interactive
- وضع /fast (سرعة رمز 1.5x)
طريقة الوصول:
- تطبيق سطح المكتب Codex
- واجهة سحابة Codex
- API بنقاط نهاية خاصة بـ Codex
الأفضل لـ:
- تطوير البرمجيات
- توليد الأكواد وتصحيحها
- تطوير الواجهة الأمامية
- اختبار أتمتة المتصفح
مقارنة المنصات
الميزة | واجهة برمجة التطبيقات (API) | ChatGPT | Codex |
|---|---|---|---|
وصول GPT-5.4 | نعم | نعم (Plus+) | نعم |
GPT-5.4 Pro | نعم | نعم (Pro+) | نعم |
استخدام الحاسوب | نعم | محدود | نعم |
بحث الأدوات | نعم | لا | نعم |
سياق 1 مليون | نعم (تجريبي) | لا | نعم |
تكاملات مخصصة | نعم | لا | محدود |
الدفع حسب الاستخدام | نعم | اشتراك | اشتراك |
Apidog لتكامل واجهة برمجة التطبيقات (API)
عند دمج واجهة برمجة تطبيقات GPT-5.4 في التطبيقات، يوفر Apidog منصة موحدة لتطوير واجهة برمجة التطبيقات:

- اختبار الطلبات: قم بتهيئة واختبار طلبات GPT-5.4 API بصريًا دون كتابة تعليمات برمجية
- متغيرات البيئة: إدارة مفاتيح API عبر بيئات التطوير، والتجهيز، والإنتاج
- الاختبار الآلي: إنشاء مجموعات اختبار مع تأكيدات للتحقق من صحة الاستجابة
- الخوادم الوهمية: محاكاة استجابات GPT-5.4 أثناء تطوير الواجهة الأمامية لتجنب تكاليف الرموز
- التعاون الجماعي: مشاركة مجموعات API مع أنماط التكامل الموثقة
- توليد التعليمات البرمجية: إنشاء مقتطفات تعليمات برمجية لـ cURL، Python، Node.js، Go، و Java من الطلبات العاملة
استكشاف المشكلات الشائعة وإصلاحها
خطأ "النموذج غير موجود"
الخطأ: The model gpt-5.4 does not exist
الأسباب:
- خطأ إملائي في اسم النموذج (استخدم
gpt-5.4وليسgpt5.4أوgpt-5-4) - الحساب لا يمتلك وصولاً إلى GPT-5.4 بعد
- مفتاح API يفتقر إلى أذونات النموذج
الحلول:
- تحقق من اسم النموذج الدقيق:
gpt-5.4 - تحقق من أن الفوترة نشطة
- أنشئ مفتاح API جديدًا بأذونات صحيحة
- انتظر 24 ساعة إذا كان الحساب قد تم إنشاؤه حديثًا
خطأ "حصة غير كافية"
الخطأ: You exceeded your current quota
الأسباب:
- تم الوصول إلى الحد اليومي/الشهري للرموز
- فشل دفع الفاتورة
- تم الوصول إلى حدود مستوى الحساب
الحلول:
- تحقق من الاستخدام على platform.openai.com/usage
- تحقق من أن طريقة الدفع محدثة
- اطلب زيادة الحد (الإعدادات > الفواتير > الحدود)
- انتظر إعادة تعيين الحصة (يتم إعادة تعيين الحدود اليومية في منتصف الليل بالتوقيت العالمي المنسق)
فشل المصادقة
الخطأ: Invalid authentication - Please provide a valid API key
الأسباب:
- لم يتم تعيين مفتاح API في البيئة
- تنسيق مفتاح API غير صحيح
- تم إلغاء أو انتهاء صلاحية مفتاح API
الحلول:
- تحقق من متغير البيئة:
echo $OPENAI_API_KEY - تحقق أن المفتاح يبدأ بـ
sk-proj-أوsk- - أعد إنشاء المفتاح إذا تم اختراقه
- أعد تشغيل التطبيق بعد تعيين متغير البيئة
أخطاء حد المعدل
الخطأ: Rate limit reached for requests
الحلول:
- طبق منطق إعادة المحاولة باستخدام التراجع الأسي
- قلل من تكرار الطلبات
- استخدم Batch API للمعالجة المجمعة
- اطلب زيادة الحد لتلبية احتياجات الإنتاج
مشاكل الفواتير
الخطأ: Payment required أو Billing information needs updating
الحلول:
- حدّث طريقة الدفع (الإعدادات > الفواتير)
- تحقق من تاريخ انتهاء صلاحية البطاقة
- تحقق من أن عنوان الفوترة يطابق البطاقة
- اتصل بالبنك إذا تكرر رفض الشحن
- تواصل مع دعم OpenAI لمراجعة الحساب
أخطاء المهلة
الخطأ: Request timed out أو أخطاء الاتصال
الأسباب:
- مشاكل في اتصال الشبكة
- تأخيرات في معالجة جانب الخادم
- مهلة العميل قصيرة جدًا
الحلول:
- زيادة المهلة في تهيئة عميل HTTP
- تحقق من اتصال الشبكة
- طبق منطق إعادة المحاولة مع التراجع
- استخدم البث للطلبات طويلة الأمد
أفضل ممارسات الأمان
احمِ مفاتيح واجهة برمجة التطبيقات وبياناتك باستخدام ممارسات الأمان هذه.
استخدم Apidog لإنشاء مجموعات اختبار أمان شاملة لتكاملات GPT-5.4 الخاصة بك:
- اختبر سيناريوهات فشل المصادقة (مفاتيح غير صالحة، رموز منتهية الصلاحية)
- تحقق من معالجة حدود المعدل باختبارات إعادة المحاولة الآلية
- أنشئ نصوص ما قبل الطلب لتدوير مفاتيح API أثناء الاختبار
- حاكِ استجابات الأخطاء لضمان التدهور المتسق
- وثّق متطلبات الأمان في مجموعات API المشتركة كمرجع للفريق
إدارة مفتاح API
افعل:
- تخزين المفاتيح في متغيرات البيئة
- استخدام أنظمة إدارة الأسرار (AWS Secrets Manager، HashiCorp Vault)
- تدوير المفاتيح كل 90 يومًا
- استخدام مفاتيح منفصلة للتطوير/التجهيز/الإنتاج
- تقييد أذونات المفتاح إلى الحد الأدنى المطلوب
لا تفعل:
- كتابة المفاتيح مباشرة في الكود المصدري
- إدخال المفاتيح إلى نظام التحكم بالإصدار
- مشاركة المفاتيح عبر البريد الإلكتروني أو الدردشة
- استخدام مفاتيح الإنتاج في كود جانب العميل
- تسجيل مفاتيح API في سجلات التطبيق
أنماط الطلبات الآمنة
استخدم HTTPS فقط: جميع طلبات OpenAI API تستخدم HTTPS بشكل افتراضي. لا تقم أبدًا بتعطيل التحقق من شهادة SSL.
التحقق من المدخلات: نظف مدخلات المستخدم قبل إرسالها إلى واجهة برمجة التطبيقات (API) لمنع حقن المطالبة:
def sanitize_input(user_input):
# Remove or escape potentially dangerous content
dangerous_patterns = ['ignore previous instructions', 'system prompt', 'api key']
for pattern in dangerous_patterns:
user_input = user_input.replace(pattern, '[REDACTED]')
return user_inputالسجل بمسؤولية: لا تقم أبدًا بتسجيل طلبات/استجابات واجهة برمجة التطبيقات الكاملة التي تحتوي على بيانات حساسة:
import logging
# Good: Log token usage, not content
logging.info(f"API call: {response.usage.total_tokens} tokens")
# Bad: Logs sensitive content
logging.info(f"API response: {response.choices[0].message.content}")اعتبارات خصوصية البيانات
احتفاظ بصفر بيانات (ZDR): توفر OpenAI ZDR لعملاء المؤسسات:
- طلبات API لا يتم تخزينها للتدريب
- خصوصية محسنة للبيانات الحساسة
- مطلوب لبعض ميزات السلامة السيبرانية
محلية البيانات: لعملاء الاتحاد الأوروبي، توفر OpenAI خيارات محلية بيانات الاتحاد الأوروبي. اتصل بالمبيعات للحصول على التفاصيل.
التعامل مع معلومات التعريف الشخصية (PII): تجنب إرسال معلومات التعريف الشخصية (PII) إلى واجهة برمجة التطبيقات (API):
- الأسماء، رسائل البريد الإلكتروني، أرقام الهواتف
- أرقام الضمان الاجتماعي
- أرقام الحسابات المالية
- المعلومات الصحية (HIPAA)
إذا كانت معلومات التعريف الشخصية مطلوبة، نفذ ما يلي:
- تقليل البيانات (إرسال ما هو ضروري فقط)
- إخفاء الهوية قبل استدعاءات واجهة برمجة التطبيقات
- التشفير أثناء النقل وفي حالة السكون
أمان الشبكة
قائمة السماح لـ IP: يمكن لحسابات المؤسسات تكوين قوائم السماح لـ IP:
- تقييد الوصول إلى واجهة برمجة التطبيقات (API) لنطاقات IP محددة
- منع الاستخدام غير المصرح به من المفاتيح المخترقة
- التكوين في إعدادات المنظمة
نقاط نهاية VPC: يتوفر AWS PrivateLink لعملاء المؤسسات:
- اتصال خاص بواجهة برمجة تطبيقات OpenAI
- لا يمر حركة المرور عبر الإنترنت العام
- تقليل زمن الاستجابة لأحمال عمل AWS
الخلاصة
يتطلب الوصول إلى واجهة برمجة تطبيقات GPT-5.4 إعدادًا مباشرًا: إنشاء حساب، إضافة فواتير، إنشاء مفتاح API، تثبيت SDK، وتقديم طلبك الأول. تستغرق العملية بأكملها من 10 إلى 15 دقيقة.
بالنسبة للفرق التي تدمج GPT-5.4 في تطبيقات الإنتاج، فإن وجود سير عمل قوي للاختبار وتصحيح الأخطاء يسرع عملية التطوير. يوفر Apidog منصة موحدة لتصميم واجهة برمجة التطبيقات، وتصحيح الأخطاء، والاختبار، والتوثيق. استخدمها للتحقق من تكاملات GPT-5.4 الخاصة بك، وإنشاء مجموعات اختبار آلية، ومحاكاة الاستجابات أثناء التطوير، والتعاون مع أعضاء الفريق بشأن عقود واجهة برمجة التطبيقات.
ملخص الخطوات الرئيسية:
- إنشاء حساب OpenAI على platform.openai.com
- إضافة طريقة دفع وتفعيل الفوترة
- إنشاء مفتاح API بأذونات مناسبة
- تثبيت حزمة OpenAI SDK (Python، Node.js، أو استخدام cURL)
- تخزين مفتاح API في متغيرات البيئة
- إجراء طلب تجريبي للتحقق من الإعداد
ملخص التسعير:
- القياسي: 2.50 دولار/مليون رمز إدخال، 15 دولار/مليون رمز إخراج
- الاحترافي: 30 دولار/مليون رمز إدخال، 180 دولار/مليون رمز إخراج
- الدفعة/المرونة: خصم 50% متاح
- حدود المعدل الافتراضية: 60 طلب/دقيقة، 150 ألف رمز/دقيقة (المستوى 2)
الخطوات التالية:
- استكشاف قدرات GPT-5.4 (استخدام الكمبيوتر، بحث الأدوات، الرؤية)
- تطبيق منطق إعادة المحاولة لمرونة الإنتاج
- إعداد المراقبة وتنبيهات الفواتير
- مراجعة أفضل ممارسات الأمان لإدارة المفاتيح
إن كفاءة GPT-5.4 المحسّنة في استخدام الرموز ومعدلات الهلوسة المنخفضة تجعلها مناسبة لأحمال عمل الإنتاج. ابدأ باختبارات صغيرة، راقب الاستخدام، وتوسع تدريجياً مع التحقق من الأداء.
الأسئلة الشائعة
كيف أحصل على وصول إلى واجهة برمجة تطبيقات GPT-5.4؟
أنشئ حسابًا على platform.openai.com، أضف طريقة دفع في إعدادات الفواتير، أنشئ مفتاح API، واستخدم اسم النموذج gpt-5.4 في طلباتك. بدأ الوصول تدريجيًا اعتبارًا من 5 مارس 2026.
هل واجهة برمجة تطبيقات GPT-5.4 مجانية للاستخدام؟
لا. تكلفة GPT-5.4 هي 2.50 دولار لكل مليون رمز إدخال و15 دولارًا لكل مليون رمز إخراج. تتلقى الحسابات الجديدة رصيدًا بقيمة 5 دولارات (ينتهي بعد 3 أشهر). يوفر تسعير الدفعة والمرونة خصومات بنسبة 50٪.
ما الفرق بين gpt-5.4 و gpt-5.4-pro؟
يقدم GPT-5.4 Pro أقصى أداء في مهام الاستدلال المعقدة ولكنه يكلف 12 مرة أكثر (30 دولارًا/180 دولارًا مقابل 2.50 دولارًا/15 دولارًا). استخدم GPT-5.4 القياسي لمعظم أعباء العمل، والإصدار الاحترافي للمهام التي تتطلب أعلى دقة.
كيف أصلح أخطاء "النموذج غير موجود"؟
تحقق من أنك تستخدم اسم النموذج الدقيق gpt-5.4 (وليس gpt5.4 أو gpt-5-4). تحقق من أن الفوترة نشطة وأن مفتاح API لديه الأذونات الصحيحة. انتظر 24 ساعة إذا كان الحساب قد تم إنشاؤه حديثًا.
ما هي حدود المعدل لواجهة برمجة تطبيقات GPT-5.4؟
حدود المستوى 2 الافتراضية: 60 طلبًا في الدقيقة، 150,000 رمز في الدقيقة، 1,000,000 رمز في اليوم. تبدأ الحسابات الجديدة بالمستوى 1 (20 طلبًا في الدقيقة، 40 ألف رمز في الدقيقة). اطلب زيادات عبر الإعدادات > الفواتير > الحدود.
هل يمكنني استخدام GPT-5.4 مجانًا في ChatGPT؟
يتوفر GPT-5.4 Thinking لمشتركي ChatGPT Plus (20 دولارًا/الشهر)، Team (25 دولارًا/المستخدم/الشهر)، و Pro (200 دولارًا/الشهر). غير متاح في الطبقة المجانية. يستخدم الوصول عبر واجهة برمجة التطبيقات (API) تسعيرًا منفصلاً يعتمد على الرموز.
كيف يمكنني تقليل تكاليف واجهة برمجة تطبيقات GPT-5.4؟
استخدم المدخلات المخزنة مؤقتًا (خصم 90% على المطالبات المتكررة)، وحسّن طول المطالبة، وحدد رموز الإخراج باستخدام معلمة max_tokens، واستخدم المعالجة الدفعية (خصم 50% لأحمال العمل غير الفورية).
هل GPT-5.4 متاح في جميع أنحاء العالم؟
واجهة برمجة تطبيقات GPT-5.4 متاحة في معظم الدول التي تعمل فيها OpenAI. توجد بعض القيود في مناطق معينة. تحقق من platform.openai.com لمعرفة التوافر حسب البلد أثناء التسجيل.
كيف أقوم بتدوير مفاتيح API بشكل آمن؟
أنشئ مفتاحًا جديدًا، وحدث جميع التطبيقات بالمفتاح الجديد، واختبر بدقة، ثم احذف المفتاح القديم من لوحة تحكم OpenAI. استخدم متغيرات البيئة أو أنظمة إدارة الأسرار لتجنب تغييرات التعليمات البرمجية.
ماذا يحدث إذا تجاوزت حد معدلي؟
ستتلقى خطأ HTTP 429. طبق منطق إعادة المحاولة بالتراجع الأسي (تأخيرات 1 ثانية، 2 ثانية، 4 ثوانٍ). فكر في استخدام Batch API للمعالجة المجمعة أو طلب زيادة الحد لتلبية احتياجات الإنتاج.
