تخطي إلى المحتوى
GetAPI
العربية
القائمة

GetAPI.ONE

استدعاء GetAPI.ONE من Node.js

استخدم OpenAI JavaScript SDK الرسمي في بيئة Node.js موثوقة مع عنوان ONE الأساسي واعتماد بيئي ونموذج دليل دقيق.

تجهيز مشروع خادم

  • إصدار Node.js مدعوم ومشروع ESM.
  • مفتاح GetAPI.ONE مفعّل ومحدود.
  • نموذج دقيق من الدليل الحالي يعلن نقطة Responses.
shell
npm install openai

إنشاء العميل والطلب

  1. مرر GETAPI_ONE_API_KEY عبر بيئة عملية الخادم.
  2. اضبط baseURL على https://www.getapi.one/v1.
  3. استبدل القيمة النائبة بمعرف دقيق من الدليل الحالي.
  4. نفّذ طلبًا صغيرًا واحدًا فقط عند قبول احتمال الفوترة.
  5. يعطل الفحص الأول التكرار التلقائي. أضف سياسة تكرار محدودة بعد تصنيف العمليات الآمنة للتكرار فقط.
node index.mjs
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 أو متغيرات الواجهة الأمامية.
  • طبّق مهلات الطلب ومعالجة الأخطاء وتفويض مستخدميك قبل إتاحة نقطة خادم.
  • دوّر المفاتيح المسربة وراجع سجلات الاستخدام للاستدعاءات غير المتوقعة.

الخطوات التالية