راهنمای شروع سریع API

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

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

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

پیکربندی‌های JSON استاندارد را به POST /v1/chat/completions برای دریافت پاسخ‌های متنی. نقطه پایان شناسه مدل شما را به‌عنوان uncensored و پارامترهایی مانند temperature و top_p. می‌توانید یک پنجره زمینه 100,000 توکنی برای هر دو prompt و completion پیکربندی کنید. اطمینان حاصل کنید که بدنه درخواست شما زیر 8 MB بماند تا از برش یا رد شدن جلوگیری شود.

Copycurl https://api.deepseekuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the capital of France?"}]
  }'

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

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

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)

Function Calling & JSON Mode

از tools و tool_choice پارامترها برای فعال‌سازی قابلیت‌های فراخوانی تابع. همچنین می‌توانید خروجی JSON دقیق را با استفاده از response_format تنظیم شده روی json_object. این ویژگی‌ها به شما امکان می‌دهند LLM را مستقیماً در پایپ‌لاین‌های داده ساختاریافته یکپارچه کنید. مدل متن خام را برمی‌گرداند، بنابراین منطق تجزیه را در کد کلاینت خود مدیریت می‌کنید.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekuncensored.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 از ۳۰۰ درخواست در دقیقه و محدودیت همزمانی هشت درخواست همزمان پشتیبانی می‌کند. اگر از این آستانه‌ها تجاوز کنید، سرور خطای 429 را برمی‌گرداند. می‌توانید مصرف خود را مانیتور کرده و موجودی خود را از طریق داشبورد شارژ کنید. اعتبار پیش‌پرداخت منقضی نمی‌شود، بنابراین می‌توانید استفاده را متوقف کنید بدون اینکه از دست بروید.

مدیریت خطا

خطاهای HTTP استاندارد مانند 401 برای کلیدهای نامعتبر و 402 زمانی که موجودی شما ناکافی است را مدیریت کنید. وضعیت 429 نشان می‌دهد که به محدودیت نرخ رسیده‌اید. خطاها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند، بنابراین درخواست‌های ناموفق رایگان هستند. همیشه بدنه پاسخ را برای پیام‌های خطای دقیق‌تر بررسی کنید تا مشکلات payload را سریع‌تر اشکال‌زدایی کنید.

Copyimport OpenAI from "openai";

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