شروع کار با DeepSeek API: راهنمای سریع

مرور کلی DeepSeek API

DeepSeek API از فرمت API سازگار با OpenAI استفاده می‌کند، به این معنی که می‌توانید با تغییرات پیکربندی ساده، از طریق SDK مربوط به OpenAI یا هر نرم‌افزار سازگار با API مربوط به OpenAI، به DeepSeek API دسترسی پیدا کنید. این راهنما به شما کمک می‌کند تا به سرعت با DeepSeek 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
      }'

استفاده از Python 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)

استفاده از Node.js 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();

نکات مهم

1. قبل از شروع، مطمئن شوید که:

   • کلید API مربوط به DeepSeek را درخواست کرده‌اید
   • SDK مناسب را نصب کرده‌اید (مثلاً pip install openai برای Python، npm install openai برای Node.js)

2. خروجی استریمینگ:

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

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

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

مراحل بعدی

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

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

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