واجهة برمجة تطبيقات DeepSeek coder: دليل البدء السريع

إعداد عنوان URL الأساسي والتكوين

حدّث تكوين العميل ليُشير إلى نقطة النهاية المستضافة الخاصة بنا. ال base_url يجب تغييره من المزود الافتراضي إلى https://api.apicoderdeepseek.com/v1 لإعادة توجيه الطلبات بشكل صحيح.

• تعيين base_url إلى القيمة أعلاه.
• حافظ على SDK القياسي كما هو لضمان التوافق.

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

إعداد الرأس للمصادقة

مرر مفتاحك في Authorization رأس للتحقق من الوصول. أنشئ حساباً عبر Google أو البريد الإلكتروني للحصول على بيانات الاعتماد الفريدة الخاصة بك فوراً.

تضمين الرأس Authorization: Bearer YOUR_API_KEY في كل طلب. يتحقق نظامنا من صحة هذا الرمز المميز قبل معالجة أي رموز أو حساب تكاليف الاستخدام.

إرسال طلب إكمال الدردشة الأول

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

تقبل واجهة برمجة التطبيقات هياكل حمولات OpenAI القياسية. يمكنك إرسال نصوص النظام، ورسائل المستخدم، وسجل المساعد في مكالمة واحدة.

تأكد من أن جسم الطلب يتضمن model و messages الحقول. سيحتوي الاستجابة على النص المُولّد في content الحقل.

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

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

تحتوي الشريحة النهائية على تفاصيل استخدام الرموز الشاردية (tokens) لشفافية الفوترة. يمكنك تتبع الرموز المدخلة والمخرجة مع وصولها.

يقلل هذا الأسلوب من زمن الاستجابة المُدرَك للردود الطويلة. يفضل المطورون التدفق لمساعدات البرمجة والتطبيقات التفاعلية.

أمثلة على استدعاء الوظائف ووضع JSON

استخدام response_format تعيين إلى json_object للمخرجات المُهيّأة. يضمن هذا أن يُرجع النموذج JSON صالحًا بدلاً من نص Markdown.

حدد مخططات الوظائف في tools معامل. سيقوم النموذج باستدعاء هذه الوظائف عند الاقتضاء بناءً على الموجه.

يدعم temperature, top_p، و stop المعلمة. المعلمات لضبط الإخراج. استخدم seed لإنتاج نتائج قابلة لإعادة الإنتاج أثناء الاختبار.

حدود معدل الطلبات ومعالجة الأخطاء

راقب معدل طلباتك لتجنب الحد من السرعة. يسمح الـ API بـ 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة.

التعامل مع HTTP 401 للمفاتيح غير الصالحة و429 لحدود معدل الطلبات. يتم دعم الطلبات التي يقل حجمها عن 8 ميجابايت. لا تستهلك الأخطاء الرصيد.

تدعم نافذة السياق ما يصل إلى 100,000 رمز مرمز إجمالاً. الحد الأقصى للإخراج هو 16,000 رمز مرمز ما لم max_tokens مضبوط على 2,048 بشكل افتراضي.

cURL

Copycurl https://api.apicoderdeepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the available endpoints for the chat completion service."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

التدفق

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)