راهنمای کاربر API DeepSeek V4

1. ثبت نام و احراز هویت

API DeepSeek V4 با OpenAI SDK سازگار است که هزینه‌های مهاجرت را به میزان قابل توجهی کاهش می‌دهد و به توسعه‌دهندگان اجازه می‌دهد تا به طور یکپارچه با ابزارهای اکوسیستم هوش مصنوعی موجود ادغام شوند.

دریافت کلید API

1. از پلتفرم DeepSeek بازدید کنید.
2. روی "API Keys" -> "Create new secret key" در گوشه بالا سمت راست کلیک کنید.
3. توجه: کلید فقط یک بار هنگام ایجاد نمایش داده می‌شود، بنابراین آن را ایمن ذخیره کنید.

2. شروع سریع (مثال Python)

ابتدا، OpenAI SDK رسمی را نصب کنید (بله، درست خواندید، فقط از OpenAI SDK استفاده کنید):

pip install openai

سپس، به سادگی دو پارامتر را تغییر دهید: base_url و api_key.

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxxx",  # کلید API DeepSeek شما
    base_url="https://api.deepseek.com"  # نکته کلیدی!
)

response = client.chat.completions.create(
    model="deepseek-v4",  # نام مدل، ممکن است پس از انتشار V4 متفاوت باشد
    messages=[
        {"role": "system", "content": "شما یک دستیار هوش مصنوعی مفید هستید."},
        {"role": "user", "content": "سلام، لطفاً DeepSeek V4 را معرفی کنید."},
    ],
    stream=False
)

print(response.choices[0].message.content)

3. ویژگی‌های پیشرفته

3.1 خروجی جریانی (Streaming)

برای افزایش تجربه کاربر، توصیه می‌شود خروجی جریانی را فعال کنید، که به کاربران امکان می‌دهد اثر تولیدی شبیه ماشین تحریر را ببینند.

stream = client.chat.completions.create(
    model="deepseek-v4",
    messages=[{"role": "user", "content": "یک شعر طولانی در مورد نهنگ‌ها بنویس"}],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

3.2 فراخوانی تابع (Function Calling)

DeepSeek V4 از Function Calling قدرتمند پشتیبانی می‌کند که قادر به تجزیه دقیق پارامترهای JSON است و آن را برای ساخت عامل‌ها (Agents) ایده‌آل می‌کند.

3.3 حالت JSON

اگر نیاز دارید که مدل فرمت JSON معتبر خروجی دهد، مطمئن شوید که json_object را در response_format مشخص کرده‌اید و صریحاً خروجی JSON را در درخواست (prompt) بخواهید.

4. قیمت‌گذاری و بهینه‌سازی هزینه

قیمت‌گذاری DeepSeek V4 بسیار مقرون‌به‌صرفه است (قیمت‌های خاص در انتظار اعلام رسمی، مرجع V3 با 0.14 دلار/میلیون توکن). برای صرفه‌جویی بیشتر در هزینه:

• کش کردن درخواست (Prompt Caching): V4 یک مکانیسم کش کردن زمینه را معرفی می‌کند. اگر درخواست سیستم (System Prompt) شما طولانی باشد (مثلاً پایگاه دانش)، درخواست‌های بعدی به دلیل برخورد با کش هزینه بسیار کمتری خواهند داشت.
• ساده‌سازی زمینه: تاریخچه چت نامربوط را در آن پر نکنید.

5. بهترین روش‌ها

• مدیریت خطا: مطمئن شوید که try-except را پیاده‌سازی می‌کنید، به ویژه برای خطاهای rate_limit_exceeded (429)، با استراتژی تلاش مجدد عقب‌نشینی نمایی.
• تنظیمات تایم‌اوت: وظایف استدلال پیچیده ممکن است به زمان‌های تولید طولانی‌تری نیاز داشته باشند، بنابراین تایم‌اوت را روی 60 ثانیه یا بیشتر تنظیم کنید.
• درخواست سیستم (System Prompt): به V4 یک "شخصیت" روشن بدهید و عملکرد بهتری خواهد داشت.

مشکل دارید؟ مستندات API ما را بررسی کنید یا برای کمک به انجمن Discord بپیوندید.