البدء السريع لمستخدمي DeepSeek

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

لاستخدام واجهة برمجة التطبيقات، وجّه عميلك إلى https://api.deepseekapi.top/v1. لا تحتاج إلى تغيير مسارات نقاط النهاية؛ تعمل نقطة النهاية القياسية /v1/chat/completions بالضبط كما هو متوقع. تعتمد المصادقة على مفتاح API واحد يتم إنشاؤه أثناء تسجيل الدخول. مرر هذا المفتاح في رأس Authorization كرمز Bearer. إذا كان المفتاح مفقودًا أو غير صالح، سيرجع الخادم خطأ 401. تأكد من ضبط متغيرات البيئة بشكل صحيح قبل إرسال طلبك الأول.

• عنوان URL الأساسي: https://api.deepseekapi.top/v1
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY

نسخcurl https://api.deepseekapi.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

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

تقبل واجهة برمجة التطبيقات طلبات إكمال الدردشة القياسية. أرسل طلب POST إلى /v1/chat/completions مع معرف نموذج uncensored. يستجيب النموذج لإدخال النص ويولد مخرجات نصية دون تطبيق فلاتر المحتوى المعتادة في DeepSeek الرسمي أو مقدمي الخدمات الكبار الآخرين. هذا يجعله مثاليًا للكتابة الإبداعية، أو لعب الأدوار، أو معالجة البيانات غير المقيدة. يمكنك التحكم في السلوك باستخدام معاملات مثل temperature و top_p. تتضمن الاستجابة النص المولد وإحصائيات استخدام الرموز.

تذكر أن النموذج ليس GPT أو Claude أو أي نموذج من مورد آخر. إنه نموذج مفتوح الأوزان مستقل مُضبط للاستخدام القانوني غير المقيد. تحقق من صفحة الأسعار لمعرفة تكاليف الرموز.

نسخfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekapi.top/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)

تكامل حزمة Node SDK

لمطوري Node.js، العملية مماثلة لتكاملات OpenAI القياسية. قم بتهيئة العميل بعنوان URL الأساسي ومفتاح API المحددين. اضبط النموذج على uncensored في تكوينك. تتعامل حزمة SDK مع دورة الطلب، بما في ذلك عمليات إعادة المحاولة ومعالجة الأخطاء، تمامًا كما تفعل مع أي خدمة متوافقة مع OpenAI. هذا يسمح لك بإعادة استخدام قواعد الشفرة الحالية بأقل قدر من الاحتكاك. تأكد من استخدام أحدث إصدار من حزمة npm openai للتوافق الكامل.

تدعم واجهة برمجة التطبيقات المكالمات المتزامنة وغير المتزامنة. يمكنك تمرير الرسائل بتنسيق المصفوفة القياسي messages. يتطابق هيكل الاستجابة مع مواصفات واجهة برمجة تطبيقات OpenAI، مما يجعل الترحيل مباشرًا.

نسخimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.deepseekapi.top/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);

استجابات البث المتدفق

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

عالج أحداث التدفق لتحديث واجهة المستخدم الخاصة بك في الوقت الفعلي. ينتهي التدفق عندما يكمل النموذج استجابته أو يصل إلى حد.

نسخstream = 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

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

اجمع بين استدعاء الدوال والبث المتدفق للتفاعلات الديناميكية. تحافظ واجهة برمجة التطبيقات على السياق عبر دورات متعددة، مما يتيح سير عمل معقد متعدد الخطوات. تأكد من أن تعريفات الدوال واضحة ومهيكلة جيدًا للحصول على أفضل النتائج.

الحدود والأخطاء ونافذة السياق

نافذة السياق الخاصة بك هي 100,000 رمز، تجمع بين الموجّه والإكمال. الحد الأقصى للإخراج هو 32,000 رمز لكل طلب، أو 2,048 إذا لم تضبط max_tokens. حدود المعدل هي 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح. إذا تجاوزت هذه الحدود، ستتلقى خطأ 429. يشير الخطأ 401 إلى مفتاح غير صالح، بينما يعني الخطأ 402 استنفاد رصيدك المسبق للدفع. لا تستهلك الأخطاء والرفضات أي رموز. الطلبات محدودة بجسم بحجم 8 ميجابايت. سجّل الدخول باستخدام Google أو البريد الإلكتروني للحصول على مفتاحك على الفور.