Token Plan (إصدار الفريق)
لا تُستخدم كحق امتياز عام للاستدعاء المباشر؛ بل يُستخدم مسار API العام لاختبار التطبيقات ودمجها.
زوج الأداة والموديل
Postman / cURL مع Alibaba Model Studio API
طرق اختبار واجهات برمجة التطبيقات للتحقق من طلبات منصة Model Studio، والرؤوس (headers)، والحمولات (payloads)، وسلوك النقطة النهائية. (API)
تُعد أدوات Postman وcURL مفيدة للتحقق من شكل الطلب، والرؤوس (headers)، وسلوك النموذج، لكنها تمثل واجهات استدعاء مباشرة لخدمة API وليست وكلاء تطوير تفاعليين.
اختر مسار الوصول المناسب
اختر مسار الوصول المناسب
استخدم مفتاح pay-as-you-go Model Studio API عامًا مع نقطة النهاية الإقليمية المقابلة. وتوضّح شركة علي بابا صراحةً أنها لا توصي باستدعاء Coding Plan من Postman.
موصى بهPay-as-you-go Model Studio API
Coding Plan
توضح شركة علي بابا صراحةً أن استدعاءات Postman غير موصى بها، وتمنع سيناريوهات API غير التفاعلية.
Pay-as-you-go Model Studio API
المسار الصحيح للتحقق اليدوي من API، والنصوص البرمجية، واختبارات التكامل، وتطوير الواجهة الخلفية.
نمط تهيئة آمن
اختبار نقطة النهاية العامة لمنصة Model Studio المتوافقة مع OpenAI
المثال مُخفَّض عمداً. استبدل العناصر النائبة فقط على جهازك، ولا تُلصق أبدًا مفتاح API حقيقي في Nfero.
قبل أن تبدأ
- أنشئ مفتاح API عامًا لـ Model Studio في منطقة النشر المُراد استخدامها.
- اختر نموذجًا مدعومًا لنفس المنطقة وبروتوكول API.
- احفظ المفتاح في متغير سري أو قيمة حالية في Postman، أو في متغير بيئة (Environment Variable).
- عيّن تنبيهات الفوترة قبل تكرار الطلبات أو أتمتتها.
نمط تهيئة آمن
- البروتوكول
- OpenAI-compatible Model Studio API
- استخدم نقطة النهاية العامة الإقليمية الموضحة في وثائق روابط URL الأساسية من علي بابا.
- أرسل المفتاح ضمن رأس التفويض (Authorization header) دون طباعته أو إدراجه في مستودع الشيفرة المصدرية.
- ابدأ بطلب بسيط قصير وحد أقصى منخفض لعدد الرموز الناتجة.
- انقل الكود الخاص بالإنتاج إلى نظام تخزين الأسرار على الجانب الخادمي بعد التحقق من صحة الطلب.
تحقق من الاتصال
- تأكد من تطابق منطقة المفتاح مع نقطة النهاية (endpoint).
- افحص حالة الرد، ومعرّف الطلب (Request ID)، وهوية النموذج (Model ID)، وحقول الاستخدام.
- تأكد من أن مجموعات Postman المصدرة لا تحتوي على القيم السرية الحالية.
- تأكد من أن نقطة النهاية هي نقطة وصول عامة لمنصة Model Studio — وليست رابط URL مخصص لخطة معينة.
أزواج الموديلات
النماذج الموصى بها للبدء
استخدم هذه الأداة لتشغيل مهام البرمجة التفاعلية والاستنتاج والمراجعة والتوثيق باستخدام كل نموذج. تحقق من توفر النموذج النهائي ودعم الخطة الدقيقة في سحابة علي بابا قبل الاستخدام في الإنتاج. (Alibaba Cloud)
Qwenqwen3.7-plus
إنشاء النصوصالاستدلالالفهم البصري
أفضل زاوية مزدوجة
المسار العام الحالي للنماذج العامة؛ تأكَّد من توفره في منطقة المفتاح.
Qwenqwen3.6-flash
إنشاء النصوصالاستدلالالفهم البصري
أفضل زاوية مزدوجة
خيار فعّال لاختبار أشكال الطلبات والتحقق الأساسي من التكامل.
المشاكل الشائعة
المشاكل الشائعة
ما تراه
خطأ 401: مفتاح API غير صحيح
السبب المحتمل
إما أن يكون المفتاح مفقودًا أو مقتطعًا أو مستخرجًا من خطة أو منطقة مختلفة.
الإجراء الواجب اتخاذه
استخدم المفتاح العام من نفس منطقة ومنطقة عمل Model Studio الخاصة بنقطة النهاية.
ما تراه
تعليق غير متوقع للخطة أو حظر المفتاح
السبب المحتمل
تم استخدام مفتاح Coding Plan أو Token Plan في استدعاءات مباشرة أو آلية لخدمة API.
الإجراء الواجب اتخاذه
استبدله بمفتاح عام لخدمة API من منصة pay-as-you-go Model Studio.
قيود مهمة
- لا تلصق مفتاحًا حقيقيًّا أبدًا في Nfero أو مجموعة عامة أو سجل أوامر مُعدٍ للمشاركة أو نظام تحكم بالمصادر (Source Control).
- لا تستخدم بيانات اعتماد Coding Plan أو Token Plan في النصوص البرمجية المباشرة أو اختبارات الدفعات أو الاستدعاءات الخلفية.
- استخدم حدودًا منخفضة وتنبيهات فوترة أثناء التحقق من سلوك الطلبات.