مستندات API

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

با کلید API خود برای دسترسی فوری به LLM بدون سانسور متصل شوید. تمام درخواست‌ها به یک توکن bearer معتبر در هدر Authorization نیاز دارند. ما برای احراز هویت ناموفق یا خطاهای مسیریابی مدل هزینه‌ای دریافت نمی‌کنیم.

از URL پایه https://api.deepseekapiprices.com/v1 با هر SDK استاندارد اوپن‌ای‌آی. کلید شما دسترسی به uncensored مدل. برای ثبت‌نام شماره تلفن لازم نیست و کلید بلافاصله پس از ایجاد حساب کاربری نمایش داده می‌شود.

مثال احراز هویت

جایگزین کنید your-api-key با کلید واقعی خود. سرور توکن را قبل از پردازش درخواست شما اعتبارسنجی می‌کند.

اولین درخواست

یک تکمیل چت ساده ارسال کنید تا اتصال و کیفیت پاسخ را آزمایش کنید. این نقطه پایایی متن را در choices[0].message.content فیلد. ما از فراخوانی تابع و حالت JSON برای خروجی‌های ساختاریافته پشتیبانی می‌کنیم.

• شناسه مدل: uncensored
• نقطه پایانی: POST /v1/chat/completions
• حداکثر خروجی: 16,000 توکن

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

Copycurl https://api.deepseekapiprices.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Translate this technical documentation to German"}]
  }'

بررسی کنید که ساختار پاسخ با استاندارد OpenAI مطابقت دارد. این تضمین می‌کند که می‌توانید ارائه‌دهندگان را بدون بازنویسی منطق برنامه خود تغییر دهید.

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

پکیج رسمی OpenAI را نصب کنید و URL پایه را پیکربندی کنید. این روش با استاندارد openai کتابخانه پایتون. شما فقط نیاز دارید پیکربندی کلاینت را تنظیم کنید.

• URL پایه: https://api.deepseekapiprices.com/v1
• کلید API: تنظیم از طریق متغیر محیطی یا سازنده
• مدل: uncensored

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

Copyfrom openai import OpenAI

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

مشتری Node.js را با URL پایه سفارشی پیکربندی کنید. این به شما امکان می‌دهد از استاندارد openai بسته است. راه‌اندازی با سایر خدمات سازگار با OpenAI یکسان است.

• URL پایه: https://api.deepseekapiprices.com/v1
• بسته: openai (npm)
• مدل: uncensored

از کد زیر برای راه‌اندازی کلاینت استفاده کنید. این تضمین می‌کند که تمام درخواست‌ها به درستی مسیریابی شوند. سپس می‌توانید chat.completions.create مانند همیشه.

Copyimport OpenAI from "openai";

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

خطاها را به‌درستی مدیریت کنید تا محدودیت‌های نرخ یا اعتبار ناکافی مدیریت شوند. SDK خطاهای استاندارد را برای مشکلات API پرتاب می‌کند.

استریمینگ و استفاده از توکن

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

• استریم: پشتیبانی شده از طریق SSE
• مصرف توکن: در قطعه نهایی ارائه می‌شود
• پارامترها: temperature, top_p, stop

پردازش جریان تأخیر ادراک‌شده را برای پاسخ‌های بلند کاهش می‌دهد. این برای رابط‌های چت ضروری است. مثال زیر راه‌اندازی جریان را نشان می‌دهد.

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)

استریم را تجزیه کنید تا رابط کاربری به صورت تدریجی به‌روزرسانی شود. این کار تجربه کاربری را به طور قابل توجهی بهبود می‌بخشد.

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

به محدودیت 300 درخواست در دقیقه در هر کلید احترام بگذارید. می‌توانید 8 درخواست همزمان در همان زمان داشته باشید. بدنه درخواست نباید از 8 مگابایت تجاوز کند. خطاها و رد شدن‌ها رایگان هستند، بنابراین محدودیت‌های نرخ فقط برای درخواست‌های موفق اعمال می‌شوند.

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

محدودیت	ارزش
درخواست در دقیقه	300
درخواست‌های موازی	8
حداکثر بدنه درخواست	۸ مگابایت
پنجره زمینه	۱۰۰,۰۰۰ توکن

عبور از این محدودیت‌ها خطای ۴۲۹ را برمی‌گرداند. همزمانی را به دقت افزایش دهید تا از محدود شدن جلوگیری کنید.