وثائق واجهة برمجة تطبيقات متوافقة مع OpenAI

إعداد عنوان URL الأساسي للمصادقة

يصادق مفتاح API الخاص بك على كل طلب موجه إلى خوادمنا. ببساطة سجل الدخول باستخدام Google أو عنوان بريد إلكتروني وانسخ المفتاح من لوحة التحكم الخاصة بك. الصقه في متغير البيئة الخاص بك كـ DEEPSEEK_API_KEY وتوجيه عميلك إلى https://api.keyapideepseek.com/v1. يعمل هذا الرابط الأساسي مع أي مكتبة قياسية متوافقة مع OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

يمكنك التحقق من إعدادك عن طريق سرد النماذج المتاحة. تؤكد الاستجابة أن مفتاحك صالح ونشط. تضمن هذه الخطوة أن نقاط التكامل الخاصة بك تشير إلى نقطة النهاية غير المقيدة الصحيحة قبل إرسال الطلبات.

نقطة نهاية إكمال الدردشة

The POST /v1/chat/completions تقبل نقطة النهاية طلبك وتعيد استجابة النموذج. ترسل جسم JSON يحتوي على الرسائل، وتعليمات النظام الخاصة بك، ومعلمات مثل درجة الحرارة. معرف النموذج هو دائماً uncensored. يتعامل هذا النموذج الوحيد مع جميع احتياجاتك لتوليد النصوص دون تعقيد التوجيه.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapideepseek.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

تتعامل مكتبة SDK الخاصة بـ Python مع طلبات HTTP تلقائيًا. تمرير مفتاحك وعنوان URL الأساسي إلى مُنشئ العميل. يتطابق باقي الكود مع الأنماط القياسية لـ OpenAI. يضمن ذلك إمكانية تبديل المزودين لاحقًا دون إعادة كتابة منطق التطبيق بالكامل.

استجابات البث واستهلاك الرموز

فعّل البث عن طريق تعيين stream: true في طلبك. تُعيد واجهة برمجة التطبيقات تدفق أحداث الإرسال الخادم (SSE) من الشرائح. تحتوي كل شريحة على نص جزئي وإحصائيات الاستخدام. تتضمن الشريحة الأخيرة إجمالي عدد الرموز المميزة لطلبك.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

يقلل البث من زمن الاستجابة المُدرَك لدى المستخدمين. يمكنك عرض الرموز بمجرد وصولها. يعد هذا أمرًا حاسمًا للتوليد طويل المدى أو واجهات الدردشة التفاعلية. راقب استخدام الرموز في الجزء الأخير لتتبع استهلاك رصيدك المدفوع مسبقًا بدقة.

وضع JSON واستدعاء الوظائف

فرض إخراج مهيكل عن طريق تعيين response_format إلى {"type": "json_object"}. سيعيد النموذج بيانات JSON بدلاً من النص الحر. هذا مثالي لدمج واجهات برمجة التطبيقات أو مهام استخراج البيانات. يمكنك أيضاً تعريف تعريفات الوظائف في طلبك لاستخدام الأدوات.

يدعم النموذج tool_choice المعلمات. يمكنك فرض وظائف محددة أو ترك النموذج يقرر. هذه المرونة تتيح لك بناء وكلاء معقدين. تأكد من أن مخططات وظائفك مكتوبة بدقة لتجنب أخطاء التحليل في كود العميل الخاص بك.

حدود المعدلات والتزامن

يُقتصر كل مفتاح API على 300 طلب في الدقيقة. يمكنك إرسال ما يصل إلى 8 طلبات متزامنة في وقت واحد. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. تمنع هذه الحدود سوء الاستخدام وتضمن أداءً مستقرًا لجميع المستخدمين. يؤدي تجاوز هذه الحدود إلى إرجاع خطأ 429.

تطبيق التخفيف الأسي في مكتبة العميل الخاصة بك. أعد محاولة الطلبات الفاشلة بعد فترة تأخير قصيرة. يتعامل هذا مع مشكلات الشبكة العابرة بسلاسة. يتم شحن رصيدك المدفوع مسبقًا فقط لإكمال الناجح، وليس لإعادة محاولات حدود المعدل.

معالجة الأخطاء والرفض

يشير خطأ 401 إلى أن المفتاح غير صالح أو منتهي الصلاحية. يشير خطأ 402 إلى عدم كفاية الرصيد المدفوع مسبقاً. يشير خطأ 429 إلى تجاوز حد معدل الطلبات. يرفض النموذج الطلبات التي تحتوي على محتوى جنسي يتضمن قاصرين. يُسمح بجميع المحتويات القانونية الأخرى للبالغين.

تحقق من جسم استجابة الخطأ للحصول على رسائل تفصيلية. سجل هذه الأخطاء لتصحيح مشاكل الدمج. لا يتم استهلاك رصيدك للطلبات الفاشلة. يساعدك هذا النموذج الفاتورة الشفاف في التنبؤ بالتكاليف بدقة دون رسوم خفية.

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapideepseek.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);