میخوای DeepSeek API رو مثل یه حرفه‌ای استفاده کنی، ولی نمی‌دونی از کجا شروع کنی؟ نگران نباش! این راهنما خیلی ساده و قدم‌به‌قدم بهت نشون می‌ده که چطور کلید API بسازی، درخواست ارسال کنی، جواب بگیری و از قابلیت‌های باحال DeepSeek استفاده کنی. حتی اگه تا حالا با API کار نکردی، این راهنما کمکت می‌کنه که راحت و بدون دردسر وارد دنیای دیپ سیک بشی. همچنین اگه میخوای بیشتر با این هوش مصنوعی آشنا بشی، میتونی مقاله معرفی Deepseek ai در بلاگ دیکاردو رو مطالعه کنی.
خب حالا آماده‌ای که شروع کنیم؟
اولین ارتباط با DeepSeek API!
اگه میخوای از API دیپ‌سیک (DeepSeek) استفاده کنی، خبر خوب اینه که این API کاملاً با OpenAI سازگاره! یعنی اگه قبلاً با OpenAI API کار کردی، میتونی خیلی راحت از DeepSeek هم استفاده کنی. فقط کافیه تنظیمات رو درست کنی.
چطور کلید API بگیری؟
برای اینکه به API دسترسی داشته باشی، اول باید یه کلید API بگیری. برای این کار، روی لینک زیر کلیک کن و درخواست بده:
🔗 دریافت کلید API
در آخر مقاله ما بهت قدم به قدم دریافت کلید API و ادغامش با اپلیکیشن خودت رو آموزش دادیم!
تنظیمات لازم برای اتصال
وقتی کلید رو گرفتی، این آدرس رو به‌عنوان base_url تنظیم کن:
🔗 `https://api.deepseek.com/v1`
(نگران v1 نباش، این فقط یه نام هست و به نسخه‌ی مدل ربطی نداره.)
مدل‌های قابل استفاده
دیپ‌سیک چند مدل قوی داره که میتونی ازشون استفاده کنی:
1- deepseek-chat → این مدل ارتقا پیدا کرده و الان DeepSeek-V3 شده! برای استفاده ازش، کافیه مقدار `model=’deepseek-chat’` رو تنظیم کنی.
2- deepseek-reasoner → این مدل برای استدلال‌های پیشرفته‌ست و نسخه‌ی جدیدش DeepSeek-R1 نام داره. اگه میخوای ازش استفاده کنی، مقدار `model=’deepseek-reasoner’` رو وارد کن. برای آشنایی بیشتر با این مذل میتونی مقاله معرفی DeepSeek-R1 در بلاگ دیکاردو رو مطالعه کنی!
چطور یه درخواست چت به API بفرستی؟
حالا که کلید API رو گرفتی، وقتشه که اولین درخواستت رو ارسال کنی! برای این کار میتونی از نمونه‌کد‌هایی که در ادامه نوشتیم استفاده کنی.
دو حالت وجود داره:
1- بدون جریان (non-stream): کل جواب رو یه جا می‌بینی برای همین باید کمی صبر کنی.
2- جریانی (stream): متن رو کم‌کم دریافت می‌کنی، مثل چت‌بات‌هایی که کلمه به کلمه جواب میدن.
اگه میخوای به جای حالت اول (non-stream) پاسخ جریانی (stream) بگیری، کافیه مقدار `stream=false` رو به `stream=true` تغییر بدی!
نمونه curl:
curl https://api.deepseek.com/chat/completions \
-H “Content-Type: application/json” \
-H “Authorization: Bearer ” \
-d ‘{
“model”: “deepseek-chat”,
“messages”: [
{“role”: “system”, “content”: “You are a helpful assistant.”},
{“role”: “user”, “content”: “Hello!”}
],
“stream”: false
}’
نمونه python:
# Please install OpenAI SDK first: `pip3 install openai`from openai import OpenAI
client = OpenAI(api_key=””, base_url=”https://api.deepseek.com”)
response = client.chat.completions.create(
model=”deepseek-chat”,
messages=[
{“role”: “system”, “content”: “You are a helpful assistant”},
{“role”: “user”, “content”: “Hello”},
],
stream=False
)
print(response.choices[0].message.content)
توکن چیه و چجوری حساب می‌شه؟
اگه داری از DeepSeek API استفاده می‌کنی، حتماً با توکن سر و کار داری. اما توکن چیه؟
تعریف ساده‌ی توکن:
توکن‌ها واحدهای کوچیکی از متن هستن که مدل برای پردازش متن استفاده می‌کنه. ما هم از همین واحدها برای حساب کردن هزینه استفاده می‌کنیم.
توکن رو میتونی مثل یه تکه از متن در نظر بگیری، که می‌تونه یه کلمه، عدد، یا حتی یه علامت نگارشی باشه.
تبدیل متن به توکن‌ها چجوریه؟
تقریباً می‌شه گفت:
| متن | تعداد تقریبی توکن‌ها |
|---|
| 1 کاراکتر انگلیسی | ≈ 0.3 توکن |
| 1 کاراکتر چینی | ≈ 0.6 توکن |
البته این اعداد تقریبی هستن و بسته به مدل مورد استفاده، ممکنه کمی تغییر کنن. تعداد واقعی توکن‌هایی که استفاده می‌کنی، توی نتیجه API نمایش داده می‌شه.
چطور تعداد توکن‌های ورودی/خروجی رو محاسبه کنیم؟
اگه میخوای بدونی متنت دقیقاً چند توکن مصرف می‌کنه، میتونی کد توکن‌ساز نمونه رو اجرا کنی. برای این کار، فایل زیر رو دانلود کن:
حالا آماده‌ای که توکن‌هات رو مدیریت کنی!
مدل‌ها و قیمت‌گذاری
اینجا میتونی ببینی که هزینه‌ی استفاده از API دیپ سیک چجوری حساب می‌شه. قیمت‌ها بر اساس 1 میلیون توکن تعیین شدن.
هزینه بر اساس تعداد کل توکن‌هایی که مدل می‌گیره (ورودی) و برمی‌گردونه (خروجی) حساب می‌شه.
قیمت‌گذاری مدل‌ها
| مدل | طول زمینه | حداکثر توکن‌های CoT (زنجیره تفکر) | حداکثر توکن‌های خروجی | قیمت ورودی ۱ میلیون توکن (با کش) | قیمت ورودی ۱ میلیون توکن (بدون کش) | قیمت خروجی ۱ میلیون توکن |
|---|
| deepseek-chat (نسخه جدید: DeepSeek-V3) | 64K | – | 8K | 0.07 دلار
(تخفیف: 0.014 دلار) | 0.27 دلار
(تخفیف: 0.14 دلار) | 1.10 دلار
(تخفیف: 0.28 دلار) |
| deepseek-reasoner (مدل جدید: DeepSeek-R1) | 64K | 32K | 8K | 0.14 دلار | 0.55 دلار | 2.19 دلار |
چند نکته مهم درباره مدل‌ها و قیمت گذاری:
- CoT (زنجیره تفکر) یعنی یه سری توضیحات اضافی که deepseek-reasoner قبل از ارائه‌ی پاسخ نهایی تولید می‌کنه.
- اگه مقدار `max_tokens` رو مشخص نکنی، حداکثر خروجی پیش‌فرض 4K توکن خواهد بود.
- قیمت‌های تخفیف‌دار تا ۸ فوریه ۲۰۲۵ ساعت ۱۶:۰۰ (UTC) فعال هستن. بعد از اون، قیمت‌ها به حالت عادی برمی‌گردن (تخفیف شامل DeepSeek-R1 نمی‌شه).
- تعداد توکن‌های خروجی deepseek-reasoner شامل هم توکن‌های CoT و هم پاسخ نهایی می‌شه. همچنین قیمت برای همه‌ی این‌ها یکسان محاسبه می‌شه.
چطور هزینه حساب می‌شه؟
فرمول ساده‌ی محاسبه هزینه:
هزینه = تعداد توکن‌ها × قیمت هر توکن
هزینه‌ها مستقیماً از موجودی شارژ شده‌ی شما کم می‌شن. اگه موجودی هدیه داشته باشی، اول اون استفاده می‌شه.
نکته مهم: قیمت‌ها ممکنه تغییر کنن، پس همیشه بهتره قبل از استفاده، این صفحه رو چک کنی تا از آخرین قیمت‌ها مطمئن بشی.
🎛️ پارامتر دما (Temperature) – چطور مدل رو خلاق‌تر یا دقیق‌تر کنیم؟
مقدار پیش‌فرض temperature برابر با 1.0 هست، اما بسته به کاری که میخوای انجام بدی، میتونی این مقدار رو تنظیم کنی.
دما چی کار می‌کنه؟
– مقدار کمتر (مثلاً 0.0 تا 0.5) → مدل دقیق‌تر و منطقی‌تر جواب می‌ده.
– مقدار بیشتر (مثلاً 1.3 به بالا) → مدل خلاق‌تر و غیرقابل پیش‌بینی‌تر می‌شه.
بهترین مقدار دما برای کاربردهای مختلف:
| کاربرد | بهترین مقدار دما |
|---|
| برنامه‌نویسی / ریاضی (جواب‌های دقیق میخوای) | 0.0 |
| پاکسازی و تحلیل داده‌ها (تعادل بین دقت و خلاقیت) | 1.0 |
| مکالمه عمومی (جواب‌های طبیعی‌تر) | 1.3 |
| ترجمه (جملات روان‌تر) | 1.3 |
| نوشتن خلاق / شعر (خلاقیت بالا) | 1.5 |
پس اگه دنبال جواب‌های دقیق هستی، دما رو کم کن. اما اگه میخوای مدل ایده‌های خلاقانه‌تری بده، دما رو بالا ببر!
محدودیت نرخ (Rate Limit) – چقدر می‌تونم درخواست بفرستم؟
خبر خوب! DeepSeek API هیچ محدودیتی روی تعداد درخواست‌های ارسالی شما نداره! سازنده‌ها به‌طور دائم تلاش می‌کنن که این هوش مصنوعی به همه‌ی درخواست‌ها پاسخ بده.
ولی یه نکته مهم: اگه سرورها خیلی شلوغ باشن و ترافیک بالا بره، ممکنه پاسخ گرفتن از سرور یکم طول بکشه. تو این مدت، درخواستت همچنان متصل می‌مونه و بسته به نوع درخواست، ممکنه چیزای زیر رو ببینی:
- اگه درخواستت بدون جریان (Non-streaming) باشه:
سرور به‌طور مداوم خطوط خالی برمی‌گردونه.
- اگه درخواستت جریانی (Streaming) باشه:
سرور به‌طور مداوم سیگنال‌های زنده (SSE keep-alive) ارسال می‌کنه.
این پیام‌ها روی تجزیه‌ی JSON در OpenAI SDK تأثیری ندارن. اما اگه خودت داری پاسخ HTTP رو پردازش می‌کنی، حواست باشه که این پیام‌ها رو درست مدیریت کنی.
حداکثر زمان انتظار چقدره؟
اگه بعد از ۳۰ دقیقه هنوز پاسخی دریافت نکردی، سرور اتصال رو قطع می‌کنه. پس اگه این اتفاق افتاد، بهتره درخواستت رو دوباره بفرستی.
کدهای خطا – وقتی API خطا می‌ده، چیکار کنیم؟
گاهی اوقات ممکنه هنگام استفاده از Dee pSeek API با خطاهایی روبرو بشی. نگران نباش! اینجا یه لیست از خطاهای رایج و راه‌حل‌های پیشنهادی رو برات آوردم.
| کد خطا ❌ | دلیل مشکل | راه‌حل پیشنهادی 🛠️ |
|---|
| Invalid – 400 Format | درخواست فرمت درستی ندارد. | بررسی کن که بدنه‌ی درخواست با استانداردهای API هماهنگ باشه. اگه مطمئن نیستی، یه نگاهی به اسناد DeepSeek API بنداز. |
| – 401 Authentication Fails | کلید API اشتباهه یا وارد نکردی. | کلید API رو چک کن و مطمئن شو که درسته. اگه هنوز کلید نداری، اول باید یه کلید API بسازی. |
| Insufficient – 402 Balance | موجودی حسابت کافیه نیست. | موجودیت رو بررسی کن و اگه لازمه، حسابت رو شارژ کن. |
| Invalid – 422 Parameters | یه پارامتر نامعتبر توی درخواست هست. | پارامترهای درخواست رو چک کن و اصلاحشون کن. اگه نمی‌دونی کدومش مشکل داره، پیام خطا رو دقیق‌تر بخون. |
| Rate Limit – 429 Reached | داری خیلی سریع درخواست می‌فرستی! | درخواست‌ها رو یکم آهسته‌تر ارسال کن. اگه خیلی عجله داری، میتونی موقتاً از یه ارائه‌دهنده دیگه مثل OpenAI استفاده کنی. |
| Server Error – 500 | سرور یه مشکلی داره. | یه مقدار صبر کن و دوباره امتحان کن. اگه مشکل حل نشد، به تیم پشتیبانی پیام بده. |
| Server – 503 Overloaded | سرور به خاطر ترافیک بالا شلوغ شده. | چند دقیقه صبر کن و دوباره درخواست بفرست. |
یادت باشه که اکثر خطاها رو میتونی با چک کردن پیام خطا و اصلاح درخواست حل کنی.
استفاده از DeepSeek API – قدم‌به‌قدم و ساده!
اگه میخوای از DeepSeek API استفاده کنی، این راهنما بهت کمک می‌کنه که خیلی راحت و بدون دردسر همه چیز رو راه بندازی. بریم سراغ مراحل!
1- ورود به پلتفرم DeepSeek
باید وارد پلتفرم DeepSeek بشی. اگه هنوز حساب نداری، با ایمیل ثبت‌نام کن و وارد شو.
2- دریافت کلید API
برای اینکه بتونی درخواست‌های API رو ارسال کنی، به کلید API نیاز داری.
چطوری کلید بگیری؟
- وارد پلتفرم بشو و به بخش API Keys برو.
- روی “Create New API Key” کلیک کن.
- یه اسم مناسب برای کلیدت انتخاب کن تا بعداً راحت‌تر مدیریت بشه.
- کلید API رو کپی کن و یه جای امن نگه دار، چون بعداً نمی‌تونی دوباره بگیریش!
3- ادغام DeepSeek API در اپلیکیشن خودت
حالا که کلید API رو گرفتی، وقتشه که DeepSeek رو توی اپلیکیشنت استفاده کنی.
چند تا تنظیم مهم:
- مقدار `api_key` رو توی تنظیمات برنامه‌ات برابر با کلید دریافت‌شده قرار بده.
- مقدار `base_url` رو روی این آدرس تنظیم کن: `https://api.deepseek.com`
4- اضافه کردن نقطه پایانی (Endpoint)
- نقاط پایانی رو مطابق با نیاز اپلیکیشن تعریف کن.
- اگه نیاز به دریافت پاسخ‌های جریانی (streaming) داری، مطمئن شو که درخواستت درست تنظیم شده.
حالا آماده‌ای که از DeepSeek API استفاده کنی!
جمع‌بندی:
حالا که یاد گرفتی چطور DeepSeek API رو راه‌اندازی کنی و درخواست بفرستی، دیگه چیزی جلو دارت نیست! با داشتن یه کلید API و استفاده ازش، میتونی خیلی راحت DeepSeek رو با اپلیکیشن خودت ادغام کنی و داده‌های موردنیازت رو دریافت کنی. اگه دنبال دقت بالا هستی، تنظیمات مناسب رو انجام بده، اگه هم خلاقیت میخوای، با پارامترهای مختلف بازی کن. حالا نوبت توئه که DeepSeek رو امتحان کنی و از قدرت هوش مصنوعی نهایت استفاده رو ببری!
محصولات مرتبط :
