استدعاء GetAPI.ONE من Node.js
استخدم OpenAI JavaScript SDK الرسمي في بيئة Node.js موثوقة مع عنوان ONE الأساسي واعتماد بيئي ونموذج دليل دقيق.
ابدأ من هنا
شغّل هذا المثال في Node.js وليس في المتصفح. احفظ الشيفرة باسم index.mjs، ومرّر مفتاح API عبر بيئة العملية، واختر نموذجًا يدعم Responses. يطبع المثال الرد النصي؛ وقد تترتب رسوم على الطلبات.
تجهيز مشروع خادم
- إصدار Node.js مدعوم ومشروع ESM.
- مفتاح GetAPI.ONE مفعّل ومحدود.
- نموذج دقيق من الدليل الحالي يعلن نقطة Responses.
npm install openaiإنشاء العميل والطلب
- مرر GETAPI_ONE_API_KEY عبر بيئة عملية الخادم.
- اضبط baseURL على https://www.getapi.one/v1.
- استبدل القيمة النائبة بمعرف دقيق من الدليل الحالي.
- نفّذ طلبًا صغيرًا واحدًا فقط عند قبول احتمال الفوترة.
- يعطل الفحص الأول التكرار التلقائي. أضف سياسة تكرار محدودة بعد تصنيف العمليات الآمنة للتكرار فقط.
import OpenAI from 'openai';
const apiKey = process.env.GETAPI_ONE_API_KEY;
if (!apiKey) throw new Error('Set GETAPI_ONE_API_KEY before starting');
const client = new OpenAI({
apiKey,
baseURL: 'https://www.getapi.one/v1',
timeout: 30_000,
maxRetries: 0,
});
const response = await client.responses.create({
model: '<MODEL_ID_FROM_CURRENT_CATALOG>',
input: 'Reply with one short readiness check.',
});
console.log(response.output_text);إبقاء حدود بيئة التشغيل واضحة
| القرار | الاستخدام |
|---|---|
| أساس نقطة النهاية | https://www.getapi.one/v1 |
| مصدر بيانات الاعتماد | process.env.GETAPI_ONE_API_KEY |
| النموذج | معرف دقيق من الدليل الحالي، لا اسم مستعار مُخمّن |
التحقق من النتيجة المتوقعة
- يكتمل Promise ويحتوي response.output_text على الرد القصير.
- لا تظهر بيانات اعتماد في حزم العميل أو السجلات أو صفحات الخطأ.
- يظهر سجل طلب أو استخدام مطابق في وحدة ONE.
إصلاح الأخطاء الشائعة
| العَرَض | الإجراء |
|---|---|
| استثناء مفتاح مفقود | اضبط المتغير في الصدفة أو بيئة الخدمة نفسها التي تشغّل Node. |
| 401 | انسخ مفتاح ONE المفعّل مجددًا وأزل المسافات الزائدة. |
| 404 أو عملية غير مدعومة | أبقِ /v1 مرة واحدة وطابق طريقة SDK مع نقطة النموذج المعلنة. |
حماية استخدام الإنتاج
- احفظ الأسرار في مدير أسرار منصة النشر، لا في package.json أو متغيرات الواجهة الأمامية.
- طبّق مهلات الطلب ومعالجة الأخطاء وتفويض مستخدميك قبل إتاحة نقطة خادم.
- دوّر المفاتيح المسربة وراجع سجلات الاستخدام للاستدعاءات غير المتوقعة.