- ما الذي تحتاجه قبل استدعاء واجهة برمجة التطبيقات؟
- أي حقائق عن Step 3.7 Flash تهم التنفيذ؟
- كيف تستدعي Step 3.7 Flash باستخدام cURL؟
- كيف تستدعي Step 3.7 Flash من Python؟
- كيف يجب التعامل مع الإدخال متعدد الوسائط؟
- كيف يتناسب استدعاء الوظائف والمخرجات المنظمة؟
- كيف يجب على الفرق وضع الميزانية والاختبار قبل الإنتاج؟
- الأسئلة الشائعة
- مقالات مقترحة
يتوفر Step 3.7 Flash على Novita AI كنموذج لغوي كبير بدون خادم (Serverless LLM) بمعرف النموذج stepfun/step-3.7-flash، ويدعم chat/completions المتوافقة مع OpenAI، وإدخال النصوص والصور والفيديو، وإخراج النصوص، واستدعاء الوظائف، والمخرجات المنظمة، والتفكير المنطقي كما هو مذكور في صفحة النموذج. تركز هذه البداية السريعة على سير عمل المطور: كيفية استدعاء واجهة برمجة التطبيقات، وأنماط الطلبات الآمنة للاستخدام اليوم، وحقول التسعير التي يجب مراعاتها في الميزانية، والأماكن التي يجب توخي الحذر فيها قبل ربط السلوك متعدد الوسائط أو التفكير المنطقي بالإنتاج.
ما الذي تحتاجه قبل استدعاء واجهة برمجة التطبيقات؟
ابدأ بثلاث قطع من الإعدادات:
| العنصر | القيمة |
|---|---|
| مفتاح API | قم بإنشاء وتخزين مفتاح API لـ Novita AI في متغير بيئة مثل NOVITA_API_KEY. |
| عنوان URL الأساسي المتوافق مع OpenAI | https://api.novita.ai/openai |
| نقطة نهاية الدردشة الكاملة | POST https://api.novita.ai/openai/v1/chat/completions |
| معرف النموذج | stepfun/step-3.7-flash |
يسرد فهرس توثيق Novita AI عنوان URL الأساسي المتوافق مع OpenAI، و مرجع واجهة برمجة تطبيقات الدردشة الكاملة يوثق حقول الطلب والاستجابة لـ POST https://api.novita.ai/openai/v1/chat/completions.
احتفظ بمفتاح API خارج نظام التحكم في الإصدار. في التطوير المحلي، قم بتصديره في الصدفة الخاصة بك. في الإنتاج، قم بتحميله من مدير الأسرار الخاص بك:
export NOVITA_API_KEY="your_api_key"
إذا كان تطبيقك يستخدم بالفعل الدردشة الكاملة المتوافقة مع OpenAI، فعادة ما يكون مسار الترحيل صغيرًا: قم بتوجيه العميل إلى عنوان URL الأساسي لـ Novita AI، واضبط رمز التفويض الحامل (Bearer)، واستخدم معرف نموذج Step 3.7 Flash.
أي حقائق عن Step 3.7 Flash تهم التنفيذ؟
استخدم معرف النموذج الدقيق في الكود واسم العرض في واجهة المستخدم الموجهة للمستخدم. تسرد صفحة نموذج Novita الحالية Step 3.7 Flash كنموذج دردشة في سلسلة StepFun.
| الحقل | قيمة Novita الحالية |
|---|---|
| اسم العرض | Step 3.7 Flash |
| معرف نموذج API | stepfun/step-3.7-flash |
| عائلة النموذج المعروضة من Novita | StepFun |
| نوع الاستضافة | Serverless LLM |
| نقطة النهاية | chat/completions |
| أنماط الإدخال | نص، صورة، فيديو |
| أنماط الإخراج | نص |
| نافذة السياق | 262,144 رمزًا |
| الحد الأقصى لرموز الإخراج | 256,000 |
| الميزات المدرجة | بدون خادم، استدعاء وظائف، مخرجات منظمة، تفكير منطقي |
| العلامات المدرجة | MoE، >100B، NEW، مميز |
| حد معدل T1 الافتراضي المدرج | 30 طلب في الدقيقة و 50,000,000 رمز في الدقيقة |
اعتبارًا من 18 يونيو 2026، تسرد Novita أسعار الرموز التالية لـ stepfun/step-3.7-flash:
| نوع الرمز | السعر المدرج |
|---|---|
| رموز الإدخال | 0.20 دولار لكل مليون رمز |
| رموز الإخراج | 1.15 دولار لكل مليون رمز |
| رموز الإدخال لقراءة ذاكرة التخزين المؤقت | 0.04 دولار لكل مليون رمز |
يمكن أن تتغير الأسعار، وتوفر النموذج، وحدود المعدل، ومعلمات الطلب المدعومة. تحقق من صفحة نموذج Step 3.7 Flash و صفحة تسعير Novita AI قبل مراجعة المشتريات، أو إطلاق الإنتاج، أو أي التزام تسعيري موجه للعملاء.
كيف تستدعي Step 3.7 Flash باستخدام cURL؟
للاختبار الأولي، احتفظ بالطلب نصيًا فقط. هذا يؤكد المصادقة، وتوجيه النموذج، وتحليل الاستجابة، والتوليد الأساسي قبل إضافة الأدوات، أو المخططات، أو الصور، أو الفيديو.
curl "https://api.novita.ai/openai/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${NOVITA_API_KEY}" \
-d '{
"model": "stepfun/step-3.7-flash",
"messages": [
{
"role": "system",
"content": "أنت مساعد تقني موجز."
},
{
"role": "user",
"content": "أنشئ قائمة مراجعة من أربع خطوات لاختبار بوت دعم متعدد الوسائط قبل الإصدار."
}
],
"max_tokens": 512,
"temperature": 0.2
}'
يتبع الاستجابة الناجحة شكل الدردشة الكاملة الموثق من Novita AI: مصفوفة choices، ورسالة تحتوي على content مولدة، وبيانات وصفية created/model، وكائن usage عند إرجاع الاستخدام. للاستجابات المتدفقة، يشير مرجع واجهة برمجة التطبيقات إلى أن الاستخدام يظهر في الجزء الأخير من الاستجابة.
استخدم هذا الاختبار الأولي للتحقق من:
- أن مفتاح API صالح.
- أن معرف النموذج مقبول.
- أن عميلك يمكنه تحليل
choices[0].message.content. - أن التسجيل الخاص بك يلتقط الرموز المميزة للطلب والإكمال والإجمالي بدون تخزين الأسرار.
- أن سياسة المهلة وإعادة المحاولة مناسبة لحجم الطلب.
كيف تستدعي Step 3.7 Flash من Python؟
يعمل نمط Python SDK الخاص بـ OpenAI مع Novita AI عند تعيين عنوان URL الأساسي لـ Novita. قم بتثبيت SDK وتثبيت الإصدار في مشروعك الخاص وفقًا لسياسة التبعية الخاصة بك.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.novita.ai/openai",
api_key=os.environ["NOVITA_API_KEY"],
)
response = client.chat.completions.create(
model="stepfun/step-3.7-flash",
messages=[
{"role": "system", "content": "أنت مساعد تقني موجز."},
{
"role": "user",
"content": "لخص مخاطر الإصدار لسير عمل دعم العملاء الذي يقبل لقطات الشاشة وتذاكر النص الطويلة.",
},
],
max_tokens=512,
temperature=0.2,
)
print(response.choices[0].message.content)
في كود التطبيق، قم بتغليف هذا في بوابة نموذج صغيرة بدلاً من توزيع استدعاءات API الأولية عبر قاعدة الكود. تتيح لك البوابة فرض حدود الرموز الافتراضية، وتعيين مهلات لكل مسار، وتطبيع الأخطاء، وتبديل النماذج للتقييم دون تغيير منطق الأعمال.
يجب أن يلتقط الغلاف الإنتاجي العملي ما يلي:
model،prompt_tokens،completion_tokens، وtotal_tokens.- زمن الاستجابة للطلب وعدد مرات إعادة المحاولة.
- حالة HTTP وفئة خطأ API.
- ما إذا تم استخدام الأدوات، أو مخطط JSON، أو إدخال الصورة، أو إدخال الفيديو.
- ملخص طلب محرر يستثني مفاتيح API ومحتوى المستخدم الحساس.
تلك البيانات التتبعية مهمة لأن Step 3.7 Flash لديه نافذة سياق كبيرة وحد أقصى مرتفع للإخراج. هذه الحدود مفيدة، لكن يجب على أنظمة الإنتاج مع ذلك تعيين max_tokens صريحة، ورفع تحميلات المستخدم الكبيرة جدًا قبل استدعاء النموذج، ومراقبة طول الإخراج.
كيف يجب التعامل مع الإدخال متعدد الوسائط؟
تسرد Novita النص والصورة والفيديو كأنماط إدخال لـ Step 3.7 Flash والنص كنمط إخراج. تعامل مع ذلك كحدود القدرة المدعومة، ثم تحقق من شكل الحمولة الدقيق في وثائق Novita الحالية أو وحدة التحكم قبل شحن تكامل متعدد الوسائط.
للبداية السريعة، استخدم هذا الترتيب:
- قم بتشغيل الاختبار النصي فقط.
- أضف إدخال صورة واحد باستخدام تنسيق رسالة الدردشة الحالي الموثق من Novita.
- تحقق من جودة الاستجابة وشكل الاستجابة في مهمتك الحقيقية.
- أضف مجموعات صور أكبر أو فيديو فقط بعد تأكيد تنسيق الطلب، وحدود الحجم، وزمن الاستجابة، وسلوك التكلفة.
لا تفترض أن كل شكل حمولة متعددة الوسائط متوافق مع OpenAI مقبول من كل نموذج مستضاف على Novita. تتحقق صفحة نموذج Step 3.7 Flash من دعم إدخال الصور والفيديو، لكن أمثلة طلبات الفيديو أكثر حساسية لمعالجة الملفات، والوصول إلى عنوان URL، والمدة، والحجم، والتنسيق الخاص بالنموذج. إذا كانت الوثائق الحالية أو مثال وحدة التحكم لا يظهر شكل حمولة الفيديو الدقيق الذي تحتاجه، فتجنب ترميز واحد من وثائق مزود آخر.
حالات الاستخدام الجيدة الأولى للصور تشمل:
- تلخيص لقطة شاشة دعم بجانب نص تذكرة المستخدم.
- استخراج حالة واجهة المستخدم من لقطة شاشة منتج لمساعد فرز داخلي.
- مراجعة صورة ضمان الجودة وإنتاج قائمة مراجعة نصية.
يجب اختبار الفيديو بحذر أكبر. ابدأ بمقاطع قصيرة، وسجل شكل الطلب الدقيق الذي يعمل، والتقط زمن الاستجابة واستخدام الرمز، وحدد سلوكًا احتياطيًا عندما يتم رفض إدخال الفيديو، أو يكون كبيرًا جدًا، أو بطيئًا جدًا لمسارك.
كيف يتناسب استدعاء الوظائف والمخرجات المنظمة؟
تم إدراج Step 3.7 Flash مع استدعاء الوظائف والمخرجات المنظمة. في واجهة برمجة تطبيقات الدردشة الكاملة، يتم عرض استدعاء الوظائف من خلال tools، ويتم عرض المخرجات المنظمة من خلال response_format.
استخدم استدعاء الوظائف عندما يجب على النموذج اختيار أداة وإرجاع وسائط JSON بدلاً من الإجابة مباشرة على المستخدم. يوثق مرجع واجهة برمجة التطبيقات أدوات الوظائف بنوع function، و function.name، و description، ومعاملات JSON Schema parameters، وإعداد strict اختياري.
tools = [
{
"type": "function",
"function": {
"name": "create_support_ticket",
"description": "إنشاء تذكرة دعم داخلية من مشكلة أبلغ عنها المستخدم.",
"parameters": {
"type": "object",
"properties": {
"summary": {"type": "string"},
"priority": {
"type": "string",
"enum": ["low", "medium", "high"],
},
"needs_human_review": {"type": "boolean"},
},
"required": ["summary", "priority", "needs_human_review"],
},
},
}
]
response = client.chat.completions.create(
model="stepfun/step-3.7-flash",
messages=[
{
"role": "user",
"content": "تعرض صفحة إعدادات الدفع خطأ 500 بعد تحميل لقطة شاشة.",
}
],
tools=tools,
temperature=0.1,
)
استخدم المخرجات المنظمة عندما يحتاج تطبيقك إلى استجابة JSON صالحة ولا يلزم استدعاء أداة خارجية. يوثق مرجع واجهة برمجة تطبيقات الدردشة الكاملة لـ Novita response_format مع json_schema ويشير إلى أن الوضع الصارم يدعم مجموعة فرعية من JSON Schema. حافظ على المخططات المبكرة صغيرة، وتجنب ميزات المخطط الغريبة، وافشل بشكل مغلق عندما لا تتحقق استجابة النموذج من الصحة.
بالنسبة للتفكير المنطقي، ميز بين قدرة النموذج وسلوك الطلب. تسرد صفحة نموذج Step 3.7 Flash التفكير المنطقي كميزة، بينما يوثق مرجع واجهة برمجة تطبيقات الدردشة الكاملة معلمات متعلقة بالتفكير مع ملاحظات دعم خاصة بالنموذج. قبل الاعتماد على حقل تفكير في محلل إنتاجي، قم بتشغيل اختبار API مع stepfun/step-3.7-flash وتعامل مع شكل الاستجابة الدقيق الذي يتلقاه حسابك.
كيف يجب على الفرق وضع الميزانية والاختبار قبل الإنتاج؟
استخدم أسعار الرموز المدرجة لتقدير الميزانية الأولى، ثم تحقق من صحة سجلات الاستخدام الفعلية. يتم تسعير Step 3.7 Flash بشكل مختلف للإدخال والإخراج وقراءات ذاكرة التخزين المؤقت، لذا فإن الطلبات الطويلة والمخرجات المطولة والسياق المتكرر لها ملفات تكلفة مختلفة.
على سبيل المثال، قد ينفق التطبيق الذي يرسل نصوص دعم كبيرة معظم ميزانيته على رموز الإدخال. قد ينفق الوكيل الذي يطلب خططًا طويلة أكثر على رموز الإخراج. قد يستفيد سير عمل الاسترجاع أو الذاكرة الذي يعيد استخدام السياق من تسعير قراءة ذاكرة التخزين المؤقت إذا كان سلوك ذاكرة التخزين المؤقت ينطبق على نمط الطلب المنشور.
قبل الإنتاج، قم بتشغيل مجموعة تقييم تتضمن:
- طلبات نصية قصيرة فقط لقياس زمن الاستجابة وجودة الإجابة الأساسية.
- طلبات سياق طويلة قريبة من الحد الأعلى المتوقع، وليس الحد الأقصى لنافذة السياق.
- طلبات صور تطابق مصدر التحميل الحقيقي ومعالجة الملف.
- طلبات استدعاء أدوات حيث يكون السلوك الصحيح هو استدعاء دالة.
- طلبات مخطط JSON تختبر عمدًا الحقول غير الصالحة والمفقودة والحالات الحدودية.
- حالات فشل للإدخال كبير جدًا، والوسائط المفقودة، ومفاتيح API غير صالحة، والمهلات.
لا توجه كل حركة المرور إلى نموذج جديد بناءً على قائمة الميزات فقط. تخبرك أعلام الميزات بما هو متاح؛ يخبرك التقييم ما إذا كان النموذج يتبع تعليماتك ومخططاتك وقواعد السلامة وميزانية زمن الاستجابة على عبء العمل الخاص بك.
الأسئلة الشائعة
هل Step 3.7 Flash متاح من خلال Novita AI؟
نعم. تسرد Novita Step 3.7 Flash كنموذج لغوي كبير بدون خادم (Serverless LLM) بمعرف نموذج API stepfun/step-3.7-flash.
ما هي نقطة النهاية التي يجب استخدامها لـ Step 3.7 Flash؟
استخدم نقطة نهاية الدردشة الكاملة المتوافقة مع OpenAI: POST https://api.novita.ai/openai/v1/chat/completions.
هل يدعم Step 3.7 Flash إدخال الصور والفيديو؟
تسرد Novita النص والصورة والفيديو كأنماط إدخال لـ Step 3.7 Flash، مع النص كنمط إخراج. استخدم وثائق Novita الحالية أو أمثلة وحدة التحكم للتحقق من شكل الحمولة الدقيق للصورة أو الفيديو قبل الإنتاج.
كم تكلفة Step 3.7 Flash؟
اعتبارًا من 18 يونيو 2026، تسرد Novita stepfun/step-3.7-flash بسعر 0.20 دولار لكل مليون رمز إدخال، و1.15 دولار لكل مليون رمز إخراج، و0.04 دولار لكل مليون رمز إدخال لقراءة ذاكرة التخزين المؤقت.
هل يدعم Step 3.7 Flash استدعاء الوظائف والمخرجات المنظمة؟
نعم. تسرد Novita استدعاء الوظائف والمخرجات المنظمة كميزات لـ Step 3.7 Flash. استخدم tools لاستدعاء الوظائف و response_format للمخرجات المنظمة، ثم اختبر المخطط والمحلل الخاص بك قبل الإنتاج.
هل يجب علي نسخ حمولة فيديو من مزود آخر؟
لا. حتى عندما تكون واجهات برمجة التطبيقات متوافقة مع OpenAI، يمكن أن تختلف معالجة الملفات وعناوين URL للوسائط المتعددة. استخدم شكل حمولة تم التحقق منه في وثائق Novita الحالية، أو أمثلة وحدة التحكم، أو اختبار API الناجح الخاص بك لـ stepfun/step-3.7-flash.
