- ما الذي تحتاجه قبل استدعاء الواجهة البرمجية؟
- ما هي حقائق Step 3.7 Flash المهمة للتنفيذ؟
- كيف تستدعي Step 3.7 Flash باستخدام cURL؟
- كيف تستدعي Step 3.7 Flash من Python؟
- كيف يجب التعامل مع الإدخال متعدد الوسائط؟
- كيف يتناسب استدعاء الدوال والمخرجات المنظمة؟
- كيف يجب على الفرق وضع الميزانية والاختبار قبل الإنتاج؟
- الأسئلة الشائعة
- مقالات موصى بها
يتوفر Step 3.7 Flash على Novita AI كـ LLM بدون خادم بمعرف النموذج stepfun/step-3.7-flash، وواجهة chat/completions المتوافقة مع OpenAI، ودعم إدخال النصوص والصور والفيديو، وإخراج النصوص، واستدعاء الدوال، والمخرجات المنظمة، والتفكير المدرجة في صفحة النموذج. تركز هذه البداية السريعة على سير عمل المطور: كيفية استدعاء الواجهة البرمجية، وأنماط الطلبات الآمنة للاستخدام اليوم، وحقول الأسعار التي يجب وضع ميزانية لها، وأين يجب توخي الحذر قبل ربط السلوك متعدد الوسائط أو التفكير في الإنتاج. للحصول على نظرة أوسع لميزات النموذج وتحديد موقعه، راجع نظرة عامة على Step 3.7 Flash API.
ما الذي تحتاجه قبل استدعاء الواجهة البرمجية؟
ابدأ بثلاثة عناصر تكوين:
| العنصر | القيمة |
|---|---|
| مفتاح API | قم بإنشاء وتخزين مفتاح Novita AI API في متغير بيئة مثل 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 |
| نوع الاستضافة | LLM بدون خادم |
| نقطة النهاية | chat/completions |
| وسائط الإدخال | نص، صورة، فيديو |
| وسائط الإخراج | نص |
| نافذة السياق | 262,144 رمزًا |
| الحد الأقصى لرموز الإخراج | 256,000 |
| الميزات المدرجة | بدون خادم، استدعاء الدوال، مخرجات منظمة، تفكير |
| التصنيفات المدرجة | MoE، >100B، جديد، مميز |
| حد معدل T1 الافتراضي المدرج | 30 RPM و 50,000,000 TPM |
اعتبارًا من 18 يونيو 2026، تدرج Novita أسعار الرموز التالية لـ stepfun/step-3.7-flash:
| نوع الرمز | السعر المدرج |
|---|---|
| رموز الإدخال | 0.20 دولار لكل 1 مليون رمز |
| رموز الإخراج | 1.15 دولار لكل 1 مليون رمز |
| رموز إدخال قراءة ذاكرة التخزين المؤقت | 0.04 دولار لكل 1 مليون رمز |
يمكن أن تتغير الأسعار وتوفر النموذج وحدود المعدل ومعاملات الطلب المدعومة. تحقق من صفحة نموذج 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 أن الاستخدام يظهر في الجزء الأخير من الاستجابة.
استخدم اختبار التدخين هذا للتحقق من:
- مفتاح API صالح.
- معرف النموذج مقبول.
- يمكن لعميلك تحليل
choices[0].message.content. - التقاط السجلات الخاصة بك للاستعلام والإكمال وإجمالي الرموز دون تخزين الأسرار.
- سياسة المهلة وإعادة المحاولة مناسبة لحجم الاستعلام.
كيف تستدعي Step 3.7 Flash من Python؟
يعمل نمط OpenAI Python SDK مع 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 بدلاً من الإجابة مباشرة على المستخدم. يوثق مرجع API أدوات الدوال بنوع function، و function.name، و description، ومعلمات مخطط JSON 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. حافظ على صغر المخططات المبكرة، وتجنب ميزات المخطط غير المألوفة، وفشل بشكل مغلق عندما لا تتحقق استجابة النموذج.
بالنسبة للتفكير، ميّز قدرة النموذج عن سلوك الطلب. تدرج صفحة نموذج Step 3.7 Flash التفكير كميزة، بينما يوثق مرجع API للمحادثات الكاملة معاملات متعلقة بالتفكير مع ملاحظات دعم خاصة بالنموذج. قبل الاعتماد على حقل تفكير في محلل إنتاجي، قم بتشغيل اختبار API مع stepfun/step-3.7-flash وتعامل مع شكل الاستجابة الدقيق الذي يستقبله حسابك.
كيف يجب على الفرق وضع الميزانية والاختبار قبل الإنتاج؟
استخدم أسعار الرموز المدرجة لتقدير الميزانية الأولى، ثم تحقق من سجلات الاستخدام الحقيقية. يتم تسعير Step 3.7 Flash بشكل مختلف للإدخال والإخراج وقراءات ذاكرة التخزين المؤقت، لذا فإن الاستفسارات الطويلة والمخرجات المطولة والسياق المتكرر لها ملفات تكلفة مختلفة. إذا كنت تقارن Novita AI مع موفري LLM API الآخرين، يغطي دليل أفضل موفري LLM API لعام 2026 مستويات الأسعار وحدود المعدل والمقايضات بين المزودين. للفرق التي لا تزال تقيّم مزود الاستدلال المناسب لعبء عمل الوكيل، يرشدك اختيار مزود استدلال للوكلاء AI عبر معايير التقييم الرئيسية.
على سبيل المثال، قد ينفق تطبيق يرسل نصوص دعم كبيرة معظم ميزانيته على رموز الإدخال. قد ينفق وكيل يطلب خططًا طويلة أكثر على رموز الإخراج. قد يستفيد سير عمل الاسترجاع أو الذاكرة الذي يعيد استخدام السياق من تسعير قراءة ذاكرة التخزين المؤقت إذا كان سلوك ذاكرة التخزين المؤقت ينطبق على نمط الطلب المنشور.
قبل الإنتاج، قم بتشغيل مجموعة تقييم تتضمن:
- استفسارات نصية قصيرة فقط لقياس زمن الاستجابة وجودة الإجابة الأساسية.
- استفسارات طويلة السياق قريبة من الحد الأعلى المتوقع، وليس الحد الأقصى لنافذة السياق.
- استفسارات صور تطابق مصدر التحميل الحقيقي ومعالجة الملفات.
- استفسارات استدعاء أدوات حيث يكون السلوك الصحيح هو استدعاء دالة.
- استفسارات مخطط JSON تختبر عمدًا حقولًا غير صالحة ومفقودة وحالات حافة.
- حالات فشل للإدخال كبير جدًا، والوسائط المفقودة، ومفاتيح API غير صالحة، والمهلات.
لا توجه كل حركة المرور إلى نموذج جديد بناءً على قائمة الميزات فقط. تخبرك علامات الميزات بما هو متاح؛ يخبرك التقييم ما إذا كان النموذج يتبع تعليماتك ومخططاتك وقواعد الأمان وميزانية زمن الاستجابة في عبء عملك.
الأسئلة الشائعة
هل Step 3.7 Flash متاح عبر Novita AI؟
نعم. تدرج Novita Step 3.7 Flash كـ 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 مليون رمز إدخال، و 1.15 دولار لكل 1 مليون رمز إخراج، و 0.04 دولار لكل 1 مليون رمز إدخال قراءة ذاكرة التخزين المؤقت.
هل يدعم Step 3.7 Flash استدعاء الدوال والمخرجات المنظمة؟
نعم. تدرج Novita استدعاء الدوال والمخرجات المنظمة كميزات لـ Step 3.7 Flash. استخدم tools لاستدعاء الدوال و response_format للمخرجات المنظمة، ثم اختبر مخططك ومحللك الدقيقين قبل الإنتاج.
هل يجب علي نسخ حمولة فيديو من مزود آخر؟
لا. حتى عندما تكون واجهات برمجة التطبيقات متوافقة مع OpenAI، يمكن أن تختلف معالجة الملفات متعددة الوسائط وعناوين URL. استخدم شكل حمولة تم التحقق منها في وثائق Novita الحالية أو أمثلة وحدة التحكم أو اختبار API الناجح الخاص بك لـ stepfun/step-3.7-flash.
