تخطَّ إلى المحتوى
ساحة لعب API

ساحة لعب API

تفاعلي

جرّب كل نموذج ونقطة نهاية في المتصفح بمفتاحك الخاص — مخرجات مبثوثة، ومفتش للطلبات، وشيفرة مولّدة يمكنك لصقها مباشرة في تطبيقك.

افتح Playground

Playground هو وحدة دردشة لـ API على /docs/playground. تتحدث إلى نموذج، ويرسل Playground الطلبات نفسها التي سيرسلها كودك: إلى إحدى نقاط النهاية الثلاث، بالنموذج وتوجيهات النظام والمعلمات والأدوات التي تضبطها. ويمكن قراءة كل طلب مجدداً ككود وكأحداث بث خام.

البدء

  • أعطه مفتاحاً — عند تسجيل الدخول، يستخدم Playground مفتاح API الخاص بحسابك ويعرض رصيدك. وإن لم تسجل الدخول، اختر إضافة مفتاح والصق مفتاحاً: يبقى في هذا التبويب فقط ولا يُحفظ أبداً.
  • اختر نقطة نهاية ونموذجاً — يحتوي الشريط العلوي على مبدّل نقطة النهاية ومنتقي النموذج. وتبدأ المحادثة الجديدة على Chat Completions مع shannon-3.
  • أرسل رسالة — اكتب أدناه واضغط Enter. كل رد ينضم إلى المحادثة، فتكمل الرسالة التالية المحادثة. وتقترح الشاشة الفارغة ثلاث مطالبات للبدء ومثالاً جاهزاً لاستدعاء أداة.

تجد مفتاحك وتدوّره في صفحة Keys & usage. المفاتيح والاستخدام

نقاط النهاية والنماذج

يحدد مبدّل نقطة النهاية صيغة الطلب التي يبنيها Playground. يمكنك تغييرها في منتصف المحادثة؛ وتبقى الرسائل.

نقطة النهاية الطلب الذي يرسله المرجع
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages تنسيق Anthropic

يسرد منتقي النماذج ما يعيده GET /v1/models. يمكن البحث فيه، ويُبقي نماذجك الأخيرة في الأعلى، ويعرض لكل نموذج السعر لكل 1M token ونافذة السياق وعلامات للأدوات ومدخلات الصور والاستدلال والمخرجات المنظمة.

المحادثة

  • تتدفق الردود إلى المحادثة أثناء كتابتها. ويظهر استدلال النموذج في كتلة مستقلة يمكنك طيها.
  • تحت كل رد: الزمن حتى أول token، وعدد الـ tokens في الثانية، والزمن المنقضي، وtokens المدخلات والمخرجات مع الجزأين المخبأ والاستدلالي، وتقدير لتكلفة الدور، وسبب الانتهاء، ومعرّف الاستجابة.
  • يمكن تعديل رسالتك وإعادة إرسالها من تلك النقطة. ويمكن إعادة توليد الرد. ويمكن حذف الرسالة، ويمكن التراجع عن الحذف خلال بضع ثوانٍ.
  • إيقاف أو مفتاح Esc ينهي الرد الجاري كتابته.
  • تُرفق الصور بزر الصورة، أو باللصق، أو بإسقاط ملف، في النماذج التي تقبل الصور. وتُصغَّر الصورة إلى 1,568 بكسل على حافتها الطويلة قبل إرسالها. ويُتخطى الملف الذي يزيد على 30 MB.
  • يعرض حقل الكتابة وتوجيهات النظام عدداً من الـ tokens. وفي النماذج المفتوحة الأوزان المستضافة يكون العدد الدقيق من POST /v1/tokenize. وفي النماذج الأخرى يكون تقديراً، معلَّماً بـ ≈.
  • يبيّن الطلب الفاشل ما ينبغي فعله بعد ذلك: ضبط مفتاح عند رفضه، أو شحن الرصيد عند نفاده، أو الثواني الواجب انتظارها بعد كثرة الطلبات، أو إعادة المحاولة بعد خطأ الخادم.

إعدادات الطلب

يفتح الزر الإعدادات لوحة بستة تبويبات. الإعدادات تخص المحادثة: فلكل محادثة إعداداتها.

التبويب ما يحتويه
النظام توجيهات النظام للمحادثة، وتُرسل مع كل طلب. تملؤها خمسة قوالب، ويظهر عدد الـ tokens فيها.
المعلمات الحد الأقصى لـ tokens المخرجة، ودرجة الحرارة، وtop_p، وجهد الاستدلال، وتسلسلات الإيقاف، وseed، ومفتاحا البث والبحث على الويب. والعنصر الذي لا حقل له في نقطة النهاية المحددة يكون معطلاً ومعلَّماً.
الأدوات تعريفات الأدوات المرسلة مع الطلب: أربعة قوالب جاهزة (get_weather وread_file وrun_shell وweb_search) أو تعريفك الخاص بصيغة JSON، وtool_choice (auto أو none أو required أو أداة واحدة بالاسم). وعندما يستدعي النموذج أداة، تعرض المحادثة الاستدعاء مع مربع للنتيجة. ومع تفعيل Offer sample results تملأ نقرة واحدة نتيجة نموذجية. ويمكنك أيضاً كتابة نتيجتك الخاصة ثم إرسالها لمتابعة الدور.
مهيكل response_format: ‏text أو json_object أو json_schema مع اسم مخطط ومخطط JSON. وعند ضبط مخطط تُفحص آخر إجابة بناءً عليه وتُعلَّم في المحادثة بأنها مطابقة أو غير مطابقة. التبويب معطل على نقطة نهاية Messages، ولا يُعرض الخيار الذي لا يقبله النموذج المحدد.
الكود طلب المحادثة الحالية ككود cURL أو Python أو Node أو Go، مبنياً من المحادثة وإعداداتها. يُطبع المفتاح على شكل YOUR_API_KEY. ويمكن نسخ الكود أو فتحه في عرض كبير.
الأحداث الدور الأخير كما مرّ عبر الشبكة: كل حدث بث مع إزاحته الزمنية ومرشح، والرد المجمّع، وترويسات الرد (x-request-id وcontent-type وretry-after وdate)، ونص الطلب. وتبقى هذه حتى تُعاد تحميل الصفحة.

فحوص المدخلات

تُفحص القيم التي تكتبها قبل إرسال الطلب. وتُعلَّم القيمة الخارجة عن المدى عند حقلها، ويُمنع الإرسال حتى تُصحَّح.

الإعداد الفحص
الحد الأقصى لـ tokens المخرجة عدد صحيح من 1 إلى max_output_tokens للنموذج.
درجة الحرارة (Temperature) رقم من 0 إلى 2. وإذا تُرك فارغاً يُحذف الحقل من الطلب.
top_p رقم من 0 إلى 1. وإذا تُرك فارغاً يُحذف الحقل من الطلب.
seed عدد صحيح.
تسلسلات الإيقاف 4 على الأكثر، مفصولة بفواصل.
response_format يجب أن يكون من الأنواع التي يقبلها النموذج المحدد. والمحادثة المنقولة إلى نموذج بلا json_schema أو بلا response_format يُمنع إرسالها مع ذكر السبب.
الصور تُزال من الرسالة عند التحويل إلى نموذج يقبل النص فقط، مع ملاحظة.

مقارنة نموذجين

مقارنة نموذجين في قائمة المزيد تضيف منتقي نموذج ثانياً. عندئذٍ تذهب كل رسالة إلى النموذجين في الوقت نفسه، بالإعدادات نفسها، وتظهر الإجابتان جنباً إلى جنب، بعلامتي A و B. ويمكنك إعادة توليد جانب واحد وحده. وعندما يستدعي أحد الجانبين أداة، فإن النتيجة التي ترسلها تكمل ذلك الجانب فقط.

المشاركة والتصدير والاستيراد

  • نسخ رابط المشاركة يضمّن المحادثة في الرابط نفسه، في الجزء الذي بعد #. ولا يُرفع شيء. وتُستبعد الصور ومفتاحك وتفاصيل آخر تشغيل. ومن يفتح الرابط يحصل على المحادثة كمحادثة جديدة في Playground الخاص به.
  • المحادثة الأطول من أن يتسع لها رابط تُرفض مع ملاحظة. نزّلها بصيغة JSON بدلاً من ذلك.
  • تنزيل JSON للمحادثة يحفظ المحادثة مع إعداداتها كملف. واستيراد JSON في لوحة المحادثات يفتح مثل هذا الملف.
  • نسخ كـ cURL ينسخ الطلب الحالي كأمر cURL واحد.

ما يُحفظ وأين

ماذا أين يُحفظ
المحادثات والأدوات المحفوظة والنماذج الأخيرة وتخطيط اللوحات في هذا المتصفح. لا تُرسل إلى Shannon ولا تنتقل معك إلى جهاز آخر.
مفتاح API في ذاكرة التبويب المفتوح. المفتاح الملصوق يزول عند إعادة تحميل الصفحة أو إغلاق التبويب. وعند تسجيل الدخول يُقرأ المفتاح من حسابك في كل مرة.
أحداث البث والترويسات والطلب للدور الأخير في الصفحة المفتوحة، حتى تُعاد تحميلها.
الطلبات تُرسل من متصفحك إلى API بمفتاحك. وتُحتسب على رصيدك مثل أي طلب API آخر.

لوحة المفاتيح

المفاتيح ما يفعله
Enter إرسال الرسالة.
Shift + Enter بدء سطر جديد.
Ctrl + K فتح لوحة الأوامر: تبديل نقطة النهاية أو النموذج، أو ضبط قالب system، أو بدء محادثة جديدة، أو تبديل البث أو الأدوات أو المقارنة. على Mac: ⌘ K.
Esc إيقاف الرد الجاري كتابته، أو إغلاق لوحة مفتوحة على الشاشة الضيقة.

افتح Playground