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

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

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

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

درخواست تکمیل چت استاندارد را با cURL ارسال کنید تا پیکربندی و در دسترس بودن مدل خود را بررسی کنید. این درخواست POST ساده نشان می‌دهد که API چگونه پرامپت سیستم و پیام کاربر شما را می‌پذیرد. می‌توانید پارامترهای temperature و top_p را برای کنترل خلاقیت تنظیم کنید. پاسخ شامل متن تولید شده همراه با آمار مصرف توکن برای شفافیت صورتحساب است. اطمینان حاصل کنید که بدنه درخواست شامل شناسه مدل صحیح و کلید API شما در هدر است. این روش برای هر دو سناریوی تولید متن و فراخوانی تابع کار می‌کند. از این دستور برای تأیید اتصال قبل از ادغام در برنامه خود استفاده کنید. نقطه پایانی هر دو حالت استریم و غیر استریم را به خوبی پشتیبانی می‌کند.

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

از کتابخانه رسمی پایتون OpenAI برای تعامل با API ما با پیکربندی URL پایه و کلید API استفاده کنید. کلاینت را با اعتبارنامه‌های خود مقداردهی اولیه کنید و متد تکمیل‌های چت را با شناسه مدل دلخواه خود فراخوانی کنید. این روش به شما اجازه می‌دهد از کدبیس‌های موجود که برای OpenAI ساخته شده‌اند بدون بازنویسی عمده استفاده کنید. می‌توانید پاسخ‌ها را استریم کنید یا متن کامل را یکجا دریافت کنید. کتابخانه سریال‌سازی JSON و درخواست‌های HTTP را به‌طور خودکار مدیریت می‌کند. تنظیمات زمان‌بندی و تلاش مجدد را برای مورد استفاده خاص خود پیکربندی کنید. این روش برای خدمات بک‌اند و پایپ‌لاین‌های پردازش داده ایده‌آل است. اطمینان حاصل کنید که URL پایه را به نقطه پایانی خاص ما متصل کنید.

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

API را به برنامه‌های JavaScript یا TypeScript خود با استفاده از پکیج Node OpenAI ادغام کنید. URL پایه و کلید API را در پیکربندی کلاینت قبل از انجام هر درخواستی تنظیم کنید. این تنظیم به شما اجازه می‌دهد از روش‌های آشنا مانند chat.completions.create() با مدل uncensored ما. می‌توانید پارامترهایی مانند دما و دنباله‌های توقف را برای تنظیم خروجی ارسال کنید. SDK پاسخ‌های استریم را برای برنامه‌های بلادرنگ به صورت کارآمد مدیریت می‌کند. از این روش برای سرورهای وب یا ابزارهای خط فرمان استفاده کنید. مطمئن شوید ماژول‌های لازم را ایمپورت کرده و متغیرهای محیطی را به درستی پیکربندی کرده‌اید. این روش هر دو الگوی درخواست سینکرون و آسنکرون را پشتیبانی می‌کند.

پخش زنده و توکن‌ها

جریان‌سازی را فعال کنید تا پاسخ‌های جزئی را هنگام تولید دریافت کنید و تجربه کاربری برای رابط‌های چت بهبود یابد. API از رویدادهای ارسالی سرور (SSE) برای تحویل توکن‌ها به صورت بلادرنگ استفاده می‌کند. می‌توانید مصرف توکن را در قطعه نهایی جریان برای صورتحساب دقیق ردیابی کنید. این ویژگی توسط تمام SDKهای اصلی پشتیبانی می‌شود و در صورت نیاز می‌توان آن را به صورت دستی پیاده‌سازی کرد. جریان‌سازی تأخیر ادراک‌شده برای پاسخ‌های طولانی را کاهش می‌دهد. مقدار stream پارامتر به true در بدنه درخواست. API آمار استفاده را در رویداد آخر برمی‌گرداند، که به شما امکان می‌دهد مقدار صحیح را از اعتبار پیش‌پرداخت خود کسر کنید. این روش برای برنامه‌هایی که نیاز به بازخورد فوری دارند ضروری است.

Limits and Error Handling

محدودیت‌های نرخ را پایش کنید و خطاها را به‌طور شایسته مدیریت کنید تا اتصال پایدار تضمین شود. API اجازه 300 درخواست در دقیقه به ازای هر کلید و 8 درخواست همزمان را می‌دهد. هر بدنه درخواست نباید از 8 مگابایت تجاوز کند. اگر کلید نامعتبری ارسال کنید، خطای 401 Unauthorized دریافت خواهید کرد. خطای 402 نشان‌دهنده عدم وجود اعتبار از پیش پرداخت شده است که نیاز به شارژ از طریق رمزارز دارد. خطای 429 به معنای تجاوز از محدودیت نرخ است؛ صبر کنید و دوباره تلاش کنید. پنجره زمینه 100,000 توکن برای پرامپت و تکمیل ترکیبی است. حداکثر خروجی 16,000 توکن است مگر اینکه مقدار کمتری مشخص کنید max_tokens مقدار. همیشه کد وضعیت و بدنه پاسخ را برای پیام‌های خطای دقیق بررسی کنید.

cURL

Copycurl https://api.deepseektokenplan.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Calculate total monthly cost for 50 million tokens"}]
  }'

پایتون

Copyfrom openai import OpenAI

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