يمنحك موفّر CometAPI لـ AI SDK إمكانية الوصول إلى أكثر من 500 نموذج AI عبر واجهة TypeScript موحّدة. استخدمه لإضافة توليد النصوص، Streaming، Embeddings، وتوليد الصور إلى أي تطبيق يعمل على Node.js أو Edge runtime.Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
الميزات المدعومة
| الميزة | الطريقة | الحالة |
|---|---|---|
| توليد النصوص | generateText() | مدعوم |
| Streaming للنص | streamText() | مدعوم |
| Text embeddings | textEmbeddingModel() | مدعوم |
| توليد الصور | imageModel() | مدعوم |
المتطلبات المسبقة
- Node.js 18+
- حساب CometAPI مع مفتاح API نشط — احصل على مفتاحك من هنا
تعيين مفتاح API الخاص بك
يقرأ الموفّر متغير البيئة
COMETAPI_KEY بشكل افتراضي:استخدم متغيرات البيئة لتجنّب تضمين بيانات الاعتماد مباشرةً في الشيفرة المصدرية.
الاستخدام
توليد النص
استخدمgenerateText() للحصول على استجابة واحدة:
Streaming للنص
استخدمstreamText() للحصول على مخرجات مجزأة في الوقت الفعلي:
توليد Embeddings
استخدمtextEmbeddingModel() لإنشاء vector embeddings:
توليد الصور
استخدمimageModel() لتوليد صور من أوامر نصية:
إعداد الموفّر
يقبلcreateCometAPI الخيارات التالية:
| الخيار | النوع | الافتراضي | الوصف |
|---|---|---|---|
apiKey | string | process.env.COMETAPI_KEY | مفتاح API الخاص بـ CometAPI |
baseURL | string | https://api.cometapi.com/v1 | عنوان URL الأساسي للـ API |
headers | Record<string, string> | — | ترويسات طلب مخصّصة |
fetch | FetchFunction | — | تنفيذ fetch مخصّص |
طرق النموذج
يوفّر الموفّر عدة بانيات للنماذج:| الطريقة | القيمة المعادة | حالة الاستخدام |
|---|---|---|
cometapi(modelId) | LanguageModelV2 | توليد النصوص وStreaming (صيغة مختصرة) |
cometapi.chatModel(modelId) | LanguageModelV2 | Chat completions |
cometapi.completionModel(modelId) | LanguageModelV2 | Text completions |
cometapi.languageModel(modelId) | LanguageModelV2 | اسم بديل لـ chatModel |
cometapi.textEmbeddingModel(modelId) | EmbeddingModelV2 | Text embeddings |
cometapi.imageModel(modelId) | ImageModelV2 | توليد الصور |
نصائح واستكشاف الأخطاء وإصلاحها
نصائح واستكشاف الأخطاء وإصلاحها
- اختيار النموذج: يعمل أي نموذج من فهرس نماذج CometAPI مع طريقة النموذج المقابلة — نماذج الدردشة عبر
cometapi()، ونماذج embeddings عبرtextEmbeddingModel()، ونماذج الصور عبرimageModel(). - Fine-tuning responses: مرّر
temperatureوmaxTokensوtopPمباشرةً إلىgenerateText()أوstreamText()، مثلًاgenerateText(\{..., temperature: 0.7\}). - معالجة الأخطاء: لفّ الاستدعاءات داخل
try/catchللتعامل مع أخطاء المصادقة أو حدود المعدل أو مشكلات الشبكة. - الأمان: لا تقم أبدًا بإيداع مفاتيح API في نظام التحكم بالإصدارات. استخدم متغيرات البيئة أو مدير الأسرار.
- حدود المعدل: راقب الاستخدام في لوحة CometAPI.