مستندات API برای توسعه‌دهندگان

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

URL پایه خود را به https://api.deepseekabliterated.com/v1 و کلید خود را در Authorization header. API نیاز به پیکربندی پروکسی ندارد و مستقیماً با SDKهای استاندارد OpenAI کار می‌کند. حساب کاربری خود را از طریق گوگل یا ایمیل در دریافت کلید API صفحه برای دریافت فوری اعتبارات خود. نیازی به شماره تلفن برای ثبت‌نام نیست و کلید بلافاصله پس از ایجاد نمایش داده می‌شود. ممکن است فقط یک کلید فعال به ازای هر حساب داشته باشید؛ ایجاد یک کلید جدید، کلید قبلی را جایگزین می‌کند. از Authorization: Bearer YOUR_API_KEY هدر برای تمام درخواست‌ها. خطاها و رد شدن‌ها توکن مصرف نمی‌کنند، بنابراین می‌توانید به راحتی آزمایش کنید.

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

یک درخواست POST به /v1/chat/completions با شناسه مدل تنظیم شده به uncensored. نقطه پایانی پیکربندی‌های JSON استاندارد را می‌پذیرد و پاسخ‌های متنی برمی‌گرداند. از این دستور برای تأیید کلید خود و مشاهده مدل در عمل استفاده کنید.

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

این درخواست عملکرد پایه متن-ورودی، متن-خروجی را نشان می‌دهد. API تا 100,000 توکن برای پرامپت و تکمیل ترکیبی پشتیبانی می‌کند. حداکثر خروجی 16,000 توکن به ازای هر درخواست، یا 2,048 اگر باشد max_tokens تنظیم نشده است. پخش زنده از طریق رویدادهای ارسال‌شده توسط سرور (SSE) برای تحویل توکن در زمان واقعی در دسترس است.

یکپارچه‌سازی SDK پایتون

پکیج OpenAI Python را نصب کنید و URL پایه را طوری پیکربندی کنید که به سرویس ما اشاره کند. این به شما اجازه می‌دهد بدون تغییر در کد موجود استفاده کنید. SDK احراز هویت و قالب‌بندی درخواست‌ها را به‌طور خودکار مدیریت می‌کند. کلید API خود را به عنوان یک متغیر محیطی یا مستقیماً در مقداردهی اولیه کلاینت ارسال کنید. این روش برای هر کلاینت سازگار با OpenAI کار می‌کند، نه فقط SDK رسمی. می‌توانید از function calling، حالت JSON و پارامترهای استاندارد مانند temperature و top_pمدل به تعاریف ابزار پاسخ داده و در صورت درخواست، JSON ساختاریافته برمی‌گرداند.

Copyfrom openai import OpenAI

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

این پیکربندی سازگاری با جریان کاری فعلی شما را تضمین می‌کند. API از embeddings، تصاویر یا fine-tuning پشتیبانی نمی‌کند، بنابراین به تکمیل‌های چت محدود شوید. مصرف توکن‌ها بر اساس هر 1M توکن صورت می‌گیرد، با ورودی $0.15 و خروجی $0.50. اعتبارات کریپتو پیش‌پرداخت هرگز منقضی نمی‌شوند، بنابراین می‌توانید استفاده را متوقف کنید بدون اینکه از دست بروند.

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

از SDK نود.js OpenAI برای یکپارچه‌سازی مدل uncensored در برنامه‌های جاوااسکریپت یا تایپ‌اسکریپت خود استفاده کنید. Set the baseURL به https://api.deepseekabliterated.com/v1 و کلید API خود را ارائه دهید. این روش با تنظیمات Python مطابقت دارد و یکپارچگی را در سراسر مجموعه فناوری شما تضمین می‌کند. SDK از پاسخ‌های جریان‌دهی پشتیبانی می‌کند که توکن‌ها را همان‌طور که تولید می‌شوند تحویل می‌دهند. این تأخیر ادراک‌شده برای خروجی‌های طولانی را کاهش می‌دهد. می‌توانید خطاهایی مانند 401 (کلید نامعتبر) یا 402 (عدم اعتبار) را با منطق تلاش مجدد استاندارد مدیریت کنید. API درخواست‌ها را به 300 در دقیقه به ازای هر کلید محدود می‌کند، با محدودیت همزمانی 8 درخواست همزمان. پیاده‌سازی خود را برای رعایت این محدودیت‌ها تنظیم کنید. بدنه‌های درخواست نباید از 8 مگابایت تجاوز کنند. این محدودیت‌ها برای تمام کلیدها و حساب‌ها اعمال می‌شود.

Copyimport OpenAI from "openai";

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

توسعه‌دهندگان Node از همان صورتحساب توکن و گزینه‌های شارژ با ارز دیجیتال بهره‌مند می‌شوند. از USDT روی TRC20 یا USDC روی Base برای شارژ حساب استفاده کنید، با اعتبار اضافی برای مبالغ بالاتر.

مصرف و پخش زنده

استریمینگ را با تنظیم stream: true در درخواست شما. API رویدادهای ارسالی سرور (SSE) را با به‌روزرسانی‌های تدریجی توکن برمی‌گرداند. هر قطعه شامل متن تولید شده است و قطعه نهایی جزئیات مصرف توکن را شامل می‌شود. این به شما امکان می‌دهد خروجی را در زمان واقعی بدون انتظار برای پاسخ کامل نمایش دهید. پخش جریان با تمام پارامترها، از جمله فراخوانی تابع و حالت JSON کار می‌کند. از stop پارامتری برای کنترل طول خروجی یا شرایط توقف. API از temperature, top_p, seed, presence_penalty، و frequency_penalty برای تنظیم دقیق تولید. مصرف توکن در قطعه آخر گزارش می‌شود، بنابراین می‌توانید هزینه‌ها را به دقت ردیابی کنید. خطاها توکن مصرف نمی‌کنند، حتی در حین استریم.

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)

این رویکرد برای رابط‌های چت و تولید محتوای طولانی ایده‌آل است. پنجره زمینه 100,000 توکنی از مکالمات گسترده یا کدهای بزرگ پشتیبانی می‌کند. خروجی به 16,000 توکن در هر درخواست محدود است که تأخیر قابل پیش‌بینی را تضمین می‌کند. برای خروجی‌های طولانی‌تر، درخواست‌های خود را تقسیم کنید یا از استراتژی‌های تکه‌تکه‌سازی استفاده کنید.

Limits, errors, and context window

API محدودیت ۳۰۰ درخواست در دقیقه را اعمال می‌کند و حداکثر ۸ درخواست همزمان را مجاز می‌داند. بدنه درخواست نباید از ۸ مگابایت تجاوز کند. خطاهایی مانند 401 (کلید نامعتبر) یا 402 (اعتبار ناکافی) توکن مصرف نمی‌کنند. محدودیت‌های نرخ (429) نشان می‌دهند که از سهمیه تجاوز کرده‌اید؛ صبر کنید و دوباره تلاش کنید. پنجره زمینه (context window) از ۱۰۰,۰۰۰ توکن برای مجموع ورودی و خروجی پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن است، یا ۲,۰۴۸ اگر max_tokens تنظیم نشده باشد. مدل محتوای جنسی شامل کودکان را رد می‌کند، اما سایر محتوای بزرگسالان قانونی را اجازه می‌دهد. حریم خصوصی حفظ می‌شود؛ پرومپت‌ها برای آموزش استفاده نمی‌شوند. ایجاد حساب فقط به یک ایمیل نیاز دارد. اعتبار پیش‌پرداخت است و هرگز منقضی نمی‌شود. بازپرداخت صادر نمی‌شود، اما خطاهایی مانند بارهای دوبرابر از طریق پشتیبانی رفع می‌شوند. شارژها فقط با کریپتو است، با پاداش برای مبالغ بزرگ‌تر.