شروع کار با API دیپ‌سیک: راهنمای سریع

نمای کلی API دیپ‌سیک

API دیپ‌سیک از فرمت API سازگار با OpenAI استفاده می‌کند، به این معنی که می‌توانید با تغییرات ساده در پیکربندی، به API دیپ‌سیک با استفاده از SDK اپن‌ای‌آی یا هر نرم‌افزار سازگار با API اپن‌ای‌آی دسترسی پیدا کنید. این راهنما به شما کمک می‌کند تا به سرعت با API دیپ‌سیک شروع به کار کنید.

پارامترهای پایه پیکربندی

پارامترهای کلیدی پیکربندی شامل:

base_url: https://api.deepseek.com
- برای سازگاری با OpenAI، می‌توانید از https://api.deepseek.com/v1 نیز استفاده کنید
- توجه: v1 در اینجا ارتباطی با نسخه‌های مدل ندارد
api_key: الزامی (نیاز به درخواست دارد)
model: از deepseek-chat برای دسترسی به آخرین مدل DeepSeek-V3 استفاده کنید

مثال‌های استفاده از API

استفاده از curl

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <DeepSeek API Key>" \
  -d '{
        "model": "deepseek-chat",
        "messages": [
          {"role": "system", "content": "You are a helpful assistant."},
          {"role": "user", "content": "Hello!"}
        ],
        "stream": false
      }'

استفاده از SDK پایتون

from openai import OpenAI

client = OpenAI(api_key="<DeepSeek 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)

استفاده از SDK نود.جی‌اس

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.deepseek.com",
  apiKey: "<DeepSeek API Key>",
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "deepseek-chat",
  });

  console.log(completion.choices[0].message.content);
}

main();

نکات مهم

۱. قبل از شروع، اطمینان حاصل کنید که:

برای کلید API دیپ‌سیک درخواست داده‌اید
SDK مناسب را نصب کرده‌اید (مثلاً pip install openai برای پایتون، npm install openai برای نود.جی‌اس)

۲. خروجی جریانی:

به طور پیش‌فرض غیرجریانی است
با تنظیم stream=true جریانی را فعال کنید
جریانی برای سناریوهای پاسخ بلادرنگ ایده‌آل است

۳. اطلاعات مدل:

مدل deepseek-chat به طور کامل به DeepSeek-V3 ارتقا یافته است
رابط بدون تغییر مانده است، نیازی به تغییر کد نیست
با مشخص کردن model='deepseek-chat' به آخرین نسخه دسترسی پیدا کنید

گام‌های بعدی

پس از تکمیل تنظیمات اولیه، می‌توانید:

پارامترهای پیشرفته API را بررسی کنید
عملکرد جریانی را پیاده‌سازی کنید
در برنامه‌های خود ادغام کنید
کارایی فراخوانی API را بهینه کنید

اکنون آماده شروع ساخت برنامه‌های هوش مصنوعی خود با API دیپ‌سیک هستید!