شروع سریع: یکپارچه‌سازی API DeepSeek Coder

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

کلید API شما هر درخواستی را به endpoint میزبانی شده ما احراز هویت می‌کند. از URL پایه https://api.coderdeepseek.cc/v1 با هر SDK یا کلاینت HTTP اوپن‌ای‌آی. شناسه مدل دقیقاً uncensored. این سرویس روی سرورهای اختصاصی ما اجرا می‌شود و بازفروشی مدل‌های دیگر نیست. با ثبت‌نام از طریق گوگل یا ایمیل، بلافاصله کلید API دریافت می‌کنید. این کلید را امن نگه دارید زیرا کنترل اعتبار پیش‌پرداخت شما را در دست دارد.

احراز هویت به Authorization header. کلید خود را به عنوان یک Bearer token ارسال کنید. هر درخواست باید این هدر را برای جلوگیری از یک 401 خطا. ما از پارامترهای کوئری برای احراز هویت استفاده نمی‌کنیم. این تضمین می‌کند که هدرها تمیز باشند و با میان‌افزارهای استاندارد سازگار باشند.

ارسال درخواست‌ها: تکمیل‌های چت

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

از دستور curl زیر برای آزمایش اتصال خود استفاده کنید. مقدار YOUR_API_KEY با کلید واقعی خود. درخواست از uncensored مدل شناسه. این تأیید می‌کند که احراز هویت و موجودی اعتبار شما فعال است.

Copycurl https://api.coderdeepseek.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the library"}]
  }'

بررسی کنید که پاسخ شامل choices آرایه. هر گزینه شامل یک پیام با محتوای تولید شده است. بررسی usage object برای شمارش توکن‌ها. این به شما کمک می‌کند هزینه‌های خود را با دقت نظارت کنید.

یکپارچه‌سازی SDK Python

API را در پروژه‌های پایتون خود با استفاده از پکیج رسمی OpenAI یکپارچه کنید. URL پایه را به اندپوینت ما تنظیم کنید. کلاینت را با کلید API خود مقداردهی اولیه کنید. این امکان را به شما می‌دهد تا از روش‌های آشنا مانند chat.completions.create. SDK به‌طور خودکار پیکربندی JSON و درخواست‌های HTTP را مدیریت می‌کند.

مدل را پیکربندی کنید uncensored. پیام‌های خود را در قالب استاندارد ارسال کنید. SDK از تمام ویژگی‌های ما از جمله فراخوانی تابع و حالت JSON پشتیبانی می‌کند. می‌توانید پارامترهایی مانند temperature و top_p را مستقیماً تنظیم کنید. این کار مهاجرت از ارائه‌دهندگان دیگر را ساده می‌کند.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.coderdeepseek.cc/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 پیچیدگی‌های بیشتر را انتزاع می‌کند.

یکپارچه‌سازی Node SDK

از SDK OpenAI Node.js برای یکپارچه‌سازی با پروژه‌های JavaScript یا TypeScript خود استفاده کنید. پکیج را نصب کنید و URL پایه را پیکربندی کنید. این سازگاری با ساختار کد موجود شما را حفظ می‌کند. می‌توانید از همان روش‌هایی که در Python استفاده می‌کنید بهره ببرید. SDK از هر دو ماژول CommonJS و ES پشتیبانی می‌کند.

مدل را روی uncensored. پیام‌ها و پارامترهای خود را ارسال کنید. SDK درخواست‌های استریم و غیراستریم را مدیریت می‌کند. می‌توانید خطاها را دریافت کرده و به درستی ثبت کنید. این اطمینان حاصل می‌کند که برنامه شما تحت بار کاری پایدار بماند.

Copyimport OpenAI from "openai";

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

یکپارچه‌سازی خود را با یک پرامپت ساده آزمایش کنید. بررسی کنید که پاسخ با انتظارات شما مطابقت دارد. مصرف توکن را در شیء پاسخ بررسی کنید. این کار به ردیابی هزینه‌ها و عملکرد کمک می‌کند. SDK کار با آن را برای تکرار سریع آسان می‌کند.

پاسخ‌های استریم و مصرف توکن

استریمینگ را با تنظیم stream: true در درخواست شما. API یک جریان رویدادهای ارسالی سرور (SSE) برمی‌گرداند. شما قطعاتی از متن را همان‌طور که تولید می‌شوند دریافت می‌کنید. این امر تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. قطعه نهایی شامل کل مصرف توکن است.

رویدادهای SSE را تجزیه کنید تا محتوا را استخراج کنید. بخش‌ها را برای تشکیل پاسخ کامل به هم بچسبانید. پایش usage object در آخرین قطعه. این به شما شمارش دقیق توکن‌ها را برای صورتحساب می‌دهد. استریمینگ برای برنامه‌های بلادرنگ ایده‌آل است.

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)

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

محدودیت‌ها، خطاها و پنجره زمینه

API ما محدودیت‌های سخت‌گیرانه برای اطمینان از پایداری اعمال می‌کند. شما می‌توانید ۳۰۰ درخواست در دقیقه به ازای هر کلید ارسال کنید. تا ۸ درخواست می‌توانند به صورت همزمان اجرا شوند. بدنه درخواست نباید از ۸ مگابایت تجاوز کند. تجاوز از این محدودیت‌ها منجر به 429 خطای نرخ محدودیت. این خطاها را با پس‌زمینه نمایی مدیریت کنید.

پنجره زمینه ۱۰۰,۰۰۰ توکن است. این شامل هم ورودی و هم خروجی می‌شود. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. اگر تنظیم نکنید max_tokens, به طور پیش‌فرض روی 2,048 تنظیم می‌شود. A 401 خطا به این معنی است که کلید شما نامعتبر است. یک 402 خطا به این معنی است که اعتباری ندارید. برای ادامه استفاده از سرویس، از طریق ارز دیجیتال شارژ کنید.