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

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

ابتدا کلید API و URL پایه را بلافاصله تنظیم کنید. کلید شما پس از ثبت‌نام با گوگل یا ایمیل روی صفحه نمایش داده می‌شود. از https://api.apiseekdeep.com/v1 به‌عنوان نقطه پایانی پایه (base endpoint). کلید را در Authorization: Bearer header. این با هر SDK یا کلاینت سازگار با OpenAI کار می‌کند.

Copycurl https://api.apiseekdeep.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the total row count for the user_logs table"}]
  }'

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

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

پیام‌ها را به POST /v1/chat/completions برای تولید متن ارسال کنید. از شناسه مدل uncensored برای خروجی‌های نامحدود. متن ورودی در آرایه messages قرار می‌گیرد. API متن تولید شده را در فیلد content پاسخ برمی‌گرداند. این دقیقاً از فرمت استاندارد چت OpenAI پیروی می‌کند.

Copyfrom openai import OpenAI

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

پرامپت‌های خود را ساختاریافته نگه دارید. مدل زمینه را در محدوده‌ها به خوبی مدیریت می‌کند. خروجی متن خام بدون لایه‌های فرمت اضافی دریافت می‌کنید. خطاها کدهای HTTP استاندارد را برمی‌گردانند.

پاسخ‌های استریم (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 & Tools

ابزارها را در بدنه درخواست خود برای خروجی‌های ساختاریافته تعریف کنید. مدل می‌تواند بر اساس طرحواره شما توابع را فراخوانی کند. تعاریف ابزار را در tools آرایه. از tool_choice برای اجبار یا اجازه انتخاب خودکار. این اجازه می‌دهد جریان‌های کاری پیچیده بدون پارس کردن متن خام ایجاد شوند.

Copyimport OpenAI from "openai";

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

طرح‌های JSON خود را با دقت ساختار دهید. مدل محدودیت‌های ابزار را رعایت می‌کند. شما منطق اجرای تابع را جداگانه مدیریت می‌کنید. این کد شما را تمیز و ماژولار نگه می‌دارد.

پیکربندی حالت JSON

خروجی JSON سخت‌گیرانه را با response_format: {"type": "json_object"}مدل فقط ساختارهای JSON معتبر را برمی‌گرداند. این را برای استخراج داده یا لوله‌های داده ساختاریافته استفاده کنید. قالب‌بندی markdown را برای تجزیه تمیزتر غیرفعال کنید. این مصرف برنامه‌ای قابل اطمینان نتایج را تضمین می‌کند.

Copycurl https://api.apiseekdeep.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the total row count for the user_logs table"}]
  }'

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

پارامترها: دما، Top P، Seed

خلاقیت را با temperature و top_p. مقادیر بالاتر تصادفی‌سازی را افزایش می‌دهند. مقادیر پایین‌تر خروجی‌ها را قطعی می‌کنند. از seed برای نتایج تکرارپذیر هنگام رفع اشکال. مقدار max_tokens برای محدود کردن طول خروجی. پیش‌فرض 2,048 توکن در صورت تنظیم نشده است.

Copyfrom openai import OpenAI

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

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