الأسئلة الشائعة عن LLM API
إجابات عملية عن الإعداد والتوجيه الإقليمي والفوترة واستكشاف الأخطاء والتواصل الآمن مع الدعم. تتوفر النماذج والأسعار الحالية في صفحة الأسعار.
بدء الاستخدام وتسليم بيانات الوصول
اشترِ الوصول أو اشحنه، ثم تحقق من استلام البيانات والرصيد المتاح.
كيف أشتري مفتاح API؟
افتح صفحة الوصول، واختر باقة، وأدخل بريد التسليم، ثم أكمل الدفع. تُرسل بيانات الاعتماد الجديدة وفق تعليمات إتمام الطلب؛ وتحقق أيضاً من مجلد الرسائل غير المرغوب فيها.
كيف أشحن مفتاح API موجوداً؟
استخدم صفحة الشحن وأدخل المفتاح الموجود بعناية. لا تلصق المفتاح كاملاً أبداً في تذكرة عامة أو محادثة جماعية أو لقطة شاشة أو مستند مشترك.
دفعت ولم أتلقَّ المفتاح. ماذا أفعل؟
تحقق من حالة الدفع، وصحة بريد التسليم، وصندوق الوارد، ومجلد الرسائل غير المرغوب فيها. إذا ظل المفتاح مفقوداً بعد انتظار قصير، فتواصل مع الدعم بشكل خاص وأرسل رقم الطلب ووقت الدفع.
أين أتحقق من الرصيد والاستخدام؟
استخدم بوابة الحصة الرسمية المرتبطة بهذا الموقع. أدخل المفتاح في الصفحة الرسمية فقط، ولا ترسل بيانات الاعتماد كاملة إلى الدعم أبداً.
هل تنتهي صلاحية الرصيد المشترى؟
يبقى الرصيد القياسي المدفوع مسبقاً متاحاً حالياً حتى يُستخدم. إذا كانت لحملة أو عقد أو خطة مخصصة شروط مختلفة، فتكون الأولوية لصفحة إتمام الطلب أو الاتفاقية الموقعة.
العناوين الإقليمية وتنسيقات API
اختر العنوان حسب منطقة النشر، ثم استخدم البروتوكول الذي يتطلبه العميل أو SDK.
أي Base URL إقليمي يجب أن أستخدم؟
استخدم https://gpt-agent.cc/v1 لأمريكا الشمالية والجنوبية، وhttps://eu.gpt-agent.cc/v1 لأوروبا وأفريقيا، وhttps://hk.gpt-agent.cc/v1 لجنوب شرق آسيا وهونغ كونغ وماكاو وتايوان واليابان وكوريا وأستراليا ونيوزيلندا، وhttps://api.llm-token.cn/v1 للبر الرئيسي للصين.
ما الفرق بين Base URL وendpoint الكامل؟
ينتهي Base URL عند /v1. ويضيف endpoint الكامل المسار /chat/completions أو /responses أو /messages. اتبع اسم الحقل في عميلك ولا تضف المسار نفسه مرتين.
ما تنسيقات API المدعومة؟
تتوفر تنسيقات متوافقة مع Chat Completions وResponses وMessages. اختر التنسيق الذي تتوقعه مكتبتك أو عميلك أو سير عمل الوكيل.
أين أُدخل مفتاح API؟
استخدم حقل API Key أو Token أو Authorization. ترسل طلبات HTTP الخام عادةً Authorization: Bearer YOUR_API_KEY. احذف علامات الاقتباس والنص النائب والمسافات غير المقصودة.
أين أجد معرّف النموذج الدقيق؟
انسخه من كتالوج النماذج المباشر أو صفحة الأسعار. قد يختلف الاسم المعروض عن معرّف الطلب، لذا حافظ بدقة على حالة الأحرف والواصلات ولاحقات الإصدار.
النماذج والوسائط المتعددة وأدوات المطورين
تتغير إصدارات النماذج بمرور الوقت؛ استخدم الكتالوج المباشر بوصفه المصدر الحالي المعتمد.
ما عائلات النماذج المتاحة؟
يشمل الكتالوج عائلات GPT وClaude وGrok وDeepSeek وQwen وDoubao وKimi وGLM وMiniMax وHunyuan وStepFun وMiMo وLongCat الرئيسية. راجع صفحة الأسعار لمعرفة الإصدارات والقدرات والأسعار الحالية.
كيف أختار نموذجاً للبرمجة أو الاستدلال أو السياق الطويل أو العمل الدفعي؟
طابق القدرة المطلوبة أولاً، ثم قارن الجودة وزمن الاستجابة والسعر وحجم السياق ودعم الأدوات. اختبر الطلب الصغير نفسه على نموذجين أو ثلاثة قبل اعتماد حركة الإنتاج.
هل يدعم النظام إنشاء الصور والمدخلات متعددة الوسائط؟
نعم، للنماذج التي تحمل هذه القدرات في الكتالوج المباشر. تحقق مما إذا كان النموذج المحدد يقبل روابط الصور أو مدخلات Base64 أو يُنشئ صوراً، واتبع تنسيق الطلب المخصص له.
ما العملاء وأدوات الوكلاء التي يمكنني ربطها؟
تشمل الإعدادات الشائعة Codex CLI وClaude Code وOpenCode وOpenClaw وCursor وCline وRoo Code وKilo Code وWindsurf وCherry Studio وOpenWebUI وDify وn8n وLangChain وLM Studio. استخدم الشرح لمعرفة أسماء الحقول الدقيقة.
ماذا لو أُعيدت تسمية نموذج أو أصبح غير متاح مؤقتاً أو أُزيل؟
راجع أولاً الكتالوج المباشر وإشعارات الخدمة. إذا تعطل نموذج واحد فقط، فانتقل مؤقتاً إلى نموذج مماثل؛ وإذا تعطلت عدة نماذج، فتعامل مع الأمر كمشكلة توجيه أو صيانة.
الفوترة والحصة وحسابات الأعمال
تتبع الرسوم قواعد النموذج المباشرة والاستخدام الفعلي؛ والأسعار الترويجية ليست دائمة.
كيف تُحسب الأسعار؟
يُدفع الرصيد مسبقاً ويُخصم وفق السعر المباشر لكل نموذج، بما في ذلك رموز الإدخال والإخراج أو المضاعفات أو رسوم كل مهمة عند انطباقها. راجع صفحة الأسعار قبل الشراء أو الاستخدام في الإنتاج.
ما الذي يؤثر في تكلفة الرموز والوسائط المتعددة؟
يمكن أن يؤثر سجل المحادثة الطويل، والمخرجات الكبيرة، وإعادة المحاولة التلقائية، وحلقات أدوات الوكيل، والصور، وسلوك التخزين المؤقت في الاستخدام. اجعل الطلبات والسياق المحتفظ به صغيرين بقدر ما تسمح به المهمة.
لماذا استُهلك رصيد أكثر مما توقعت؟
تحقق من تكرار السجل، وحدود المخرجات الطويلة، والطلبات المتوازية، وإعادة محاولات SDK، وحلقات الوكيل. قارن الفترة الزمنية في بوابة الحصة بسجلات التطبيق من دون كشف مفتاح API كاملاً.
هل تدعمون الفواتير أو المشتريات أو خطط الاستخدام الكبير؟
يمكن للفرق التواصل مع الدعم بشأن الحجم والتزامن والمشتريات والفوترة واحتياجات الدعم. يجب تأكيد أي سعر مخصص أو التزام بالخدمة بشكل خاص في الاتفاقية المعمول بها.
استكشاف الأخطاء الشائعة
احتفظ بالخطأ الدقيق واسم النموذج والوقت قبل تغيير عدة إعدادات دفعة واحدة.
كيف أصلح أخطاء المصادقة 401 أو 403؟
تحقق من أن المفتاح كامل ومن دون مسافات وفي الحقل الصحيح، وأنه مستخدم مع أحد عناوين Base URL الخاصة بهذه الخدمة. إذا كان من المحتمل أن يكون قد انكشف، فتوقف عن استخدامه واستبدله.
كيف أصلح 404 أو model not found؟
تحقق من معرّف النموذج الدقيق ومسار endpoint. من الأسباب الشائعة استخدام اسم العرض، أو تكرار /v1، أو إرسال حمولة Responses أو Messages إلى مسار Chat Completions.
ماذا يعني 429 أو rate limit؟
تحقق أولاً من الرصيد المتبقي، ثم خفّض التزامن ومعدل إعادة المحاولة. إذا كان الرصيد كافياً واستمر 429، فاحتفظ باسم النموذج والوقت ولقطة الخطأ لإرسالها إلى الدعم.
ماذا أفعل عند انتهاء المهلة أو أخطاء اتصال الشبكة؟
جرّب العنوان الأقرب إلى منطقة النشر، وقلّص السياق والمخرجات، وأرسل طلباً بسيطاً. إذا تعطل عميل واحد فقط، فافحص إعدادات الوكيل والشهادة والمهلة فيه.
ماذا أفعل عند 500 أو 502 أو Bad Gateway؟
أعد المحاولة مرة واحدة بعد توقف قصير واختبر نموذجاً آخر. عادةً ما يدل تعطل نموذج واحد على مساره؛ وقد يشير تعطل عدة نماذج إلى مشكلة توجيه مشتركة أو صيانة.
كيف أعرف إن كان العطل في نموذج واحد أم في المسار كله؟
أرسل الطلب البسيط نفسه باستخدام المفتاح وBase URL نفسيهما، وغيّر معرّف النموذج فقط. يدل عطل واحد على مسار نموذج؛ أما الأعطال المتعددة فتستدعي التصعيد إلى الدعم.
الأمان والمبالغ المستردة والدعم
لا تنشر أبداً بيانات الاعتماد الكاملة أو تفاصيل الطلب أو معلومات الهوية أثناء استكشاف الأخطاء.
ماذا أفعل إذا انكشف مفتاح API؟
احذف الرسالة المكشوفة أو اسحبها، وتوقف عن استخدام المفتاح، وتواصل مع الدعم لاستبداله أو مراجعة المخاطر. أخفِ جميع الأحرف في لقطات الشاشة باستثناء بضعة أحرف من البداية والنهاية.
هل يحتاج الدعم إلى مفتاح API كاملاً؟
لا. لا يحتاج استكشاف الأخطاء العلني سوى اسم النموذج ولقطة للخطأ. يجب إجراء التحقق من الحساب المتعلق ببيانات الاعتماد عبر قناة دعم خاصة وآمنة.
ما المعلومات التي أقدمها عند الإبلاغ عن مشكلة؟
قدّم عنصرين على الأكثر: (1) اسم النموذج و(2) لقطة للخطأ تتضمن الوقت أو request ID عند توفره. لا تُدرج أبداً المفتاح الكامل أو كلمة المرور أو بطاقة الدفع أو بيانات هوية غير محجوبة.
كيف أتحقق من حالة الصيانة وأعيد المحاولة بأمان؟
راجع إشعارات الخدمة أولاً. بعد التعافي، أرسل طلباً بسيطاً واحداً بدلاً من تفعيل إعادة محاولات غير محدودة. إذا استمر الفشل، فأبلغ عن النموذج وأرفق أحدث لقطة للخطأ.
هل يمكنني طلب استرداد أو مراجعة للاستخدام؟
تخضع المبالغ المستردة والاستخدام محل النزاع لسياسة الاسترداد وحالة الطلب الفعلية. أوقف الطلبات الإضافية، ثم تواصل مع الدعم بشكل خاص وأرسل رقم الطلب والوقت ذي الصلة للمراجعة.