راهنمای یکپارچه‌سازی: کلید API deepseek coder

URL پایه و احراز هویت

کلید API شما هر درخواست را احراز هویت می‌کند. URL پایه را روی https://api.deepseekcoderapikey.com/v1 در پیکربندی کلاینت خود. این URL هم نقاط پایانی تکمیل چت و هم نقاط پایانی مدل‌ها را مدیریت می‌کند و نیازی به بخش‌های مسیر اضافی ندارد. شما یک کلید واحد برای هر حساب دریافت می‌کنید و ایجاد یک کلید جدید، بلافاصله کلید قبلی را جایگزین می‌کند.

کلید را در یک متغیر محیطی به نام ذخیره کنید DEEPSEEK_API_KEY یا مستقیماً به کلاینت SDK خود وارد کنید. نقطه پایانی (Endpoint) هدرهای استاندارد را می‌پذیرد، بنابراین می‌توانید ارائه‌دهندگان را تنها با تغییر آدرس پایه و مقدار کلید جابه‌جا کنید. این روش با Cursor، افزونه‌های VS Code و ابزارهای توسعه محلی که رابط OpenAI-compatible را انتظار دارند، کار می‌کند.

احراز هویت با وضعیت 401 در صورت عدم وجود یا نامعتبر بودن کلید شکست می‌خورد. از

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

مثال را برای بررسی اتصال پیش از ادغام در منطق برنامه خود استفاده کنید.

نقطه پایانی تکمیل چت (POST)

پیام‌ها را به POST /v1/chat/completions اندپوینت با استفاده از شناسه مدل uncensored. این انتهای‌بند، ورودی متنی را پردازش کرده و خروجی متنی برمی‌گرداند و از پاسخ‌های همزمان و استریم‌شده پشتیبانی می‌کند. می‌توانید رفتار مدل را با پارامترهایی مانند دما، top_p و دنباله‌های توقف پیکربندی کنید.

پنجره زمینه امکان استفاده تا ۱۰۰,۰۰۰ توکن برای پرامپت و تکمیل ترکیبی را فراهم می‌کند. اگر محدودیت max_tokens را مشخص نکنید، مدل به‌طور پیش‌فرض ۲,۰۴۸ توکن در هر درخواست در نظر می‌گیرد. از

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.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 رسمی پایتون OpenAI را مشاهده کنید.

خطاهایی مانند عدم موجودی کافی کد وضعیت 402 را برمی‌گردانند، در حالی که درخواست‌های نادرست کد 400 را برمی‌گردانند. برای عیب‌یابی سریع ساختار پیکربندی خود، به بدنه پاسخ برای پیام‌های خطای دقیق مراجعه کنید.

نقطه پایانی مدل‌ها (GET)

مدل‌های موجود را با ارسال یک GET /v1/models درخواست. این نقطه پایانی لیستی از اشیاء مدل را برمی‌گرداند، شامل uncensored شناسه مدل. می‌توانید از این نقطه پایانی برای تأیید اعتبار کلید API و آنلاین بودن سرویس قبل از انجام درخواست‌های سنگین استفاده کنید.

پاسخ شامل متاداده‌هایی مانند شناسه مدل، نوع شیء و اطلاعات مالکیت است. از این داده‌ها برای پیکربندی پویای برنامه خود یا ثبت مدل‌های موجود برای اهداف عیب‌یابی استفاده کنید. این نقطه پایانی به بدنه نیاز ندارد، تنها هدر احراز هویت استاندارد لازم است.

یکپارچه‌سازی این بررسی در توالی راه‌اندازی برنامه شما تضمین می‌کند که برنامه در صورت دست‌نیافت‌پذیری API، سریعاً شکست بخورد. همچنین به شما کمک می‌کند تا قبل از ادامه با تکمیل‌های چت واقعی، از پیکربندی صحیح URL پایه اطمینان حاصل کنید.

پاسخ‌های استریم (SSE)

با تنظیم stream پارامتر را در درخواست خود به true تنظیم کنید. API یک جریان رویدادهای ارسال‌شده توسط سرور (SSE) برمی‌گرداند و توکن‌ها را همان‌طور که تولید می‌شوند، ارسال می‌کند. این رویکرد تأخیر ادراک‌شده را برای دستیاران کدنویسی کاهش می‌دهد و به‌روزرسانی‌های رابط کاربری در لحظه را در برنامه شما امکان‌پذیر می‌سازد.

هر قطعه شامل محتوای جزئی است و قطعه نهایی شامل آمار کامل استفاده از توکن می‌شود. جریان SSE را با دقت تجزیه کنید تا وقفه‌های شبکه و بافر کردن توکن‌های جزئی را مدیریت نمایید. The

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

از فراخوانی تابع استفاده کنید تا به مدل اجازه دهید ابزارهای خارجی را فراخوانی کند. توابع خود را در tools پارامتر و مشخص کنید tool_choice برای کنترل زمانی که مدل از آن‌ها استفاده می‌کند. API از تعریف‌های استاندارد ابزار پشتیبانی می‌کند و به شما امکان می‌دهد با سرویس‌های بک‌اند خود یکپارچه شوید.

برای خروجی‌های ساختاریافته، حالت JSON را با تنظیم response_format به json_object. این موضوع مدل را مجبور می‌کند تا JSON معتبر بازگرداند که برای تجزیه داده‌های پیکربندی یا پاسخ‌های API مفید است.

Copyimport OpenAI from "openai";

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

قطعه کد نشان می‌دهد که چگونه حالت JSON را در Node.js پیکربندی کنید.

فراخوانی تابع را با استریم برای استفاده تعاملی از ابزارها ترکیب کنید. مدل می‌تواند چندین ابزار را در یک نوبت فراخوانی کند که اجازه می‌دهد کارهای چندمرحله‌ای پیچیده انجام شود. مطمئن شوید که کلاینت شما خروجی ابزار را به درستی مدیریت می‌کند تا زمینه مکالمه حفظ شود.

محدودیت‌های نرخ و محدودیت‌ها

کلید API شما محدود به 300 درخواست در دقیقه و 8 درخواست همزمان است. حداکثر اندازه بدنه درخواست 8 مگابایت است. اگر از این محدودیت‌ها تجاوز کنید، API خطای 429 Too Many Requests را برمی‌گرداند. در کلاینت خود از بازگشت نمایی (exponential backoff) برای مدیریت محدودیت‌های نرخ به صورت شایسته استفاده کنید.

خطاهایی مانند ۴۰۱ نشان‌دهنده کلید نامعتبر است، در حالی که ۴۰۲ نشان‌دهنده اعتبار ناکافی است. برای اعتبار بازپرداختی انجام نمی‌شود، اما موارد پرداخت مضاعف را می‌توان از طریق صفحه پشتیبانی حل کرد. اعتبار هرگز منقضی نمی‌شود، بنابراین می‌توانید هر زمان که مایل بودید اعتبار خود را افزایش دهید.

پنجره زمینه ۱۰۰,۰۰۰ توکنی شامل پرامپت و تکمیل کل است. مصرف توکن خود را برای ماندن در بودجه پایش کنید. از سیستم اعتبار پیش‌پرداخت برای پرداخت فقط به اندازه مصرف خود استفاده کنید، بدون هزینه‌های ماهانه یا اشتراک.