DeepSeek Files API (2026): الحدود، وعمليات الرفع، وfile_id في التطبيق العملي

لمحة سريعة عن الحدود

المصدر: دليل Files API الرسمي، تم الاطلاع عليه بتاريخ 2026-08-21.

ارفع لمرة واحدة واستخدم المرجع دائمًا (حسناً، حتى 30 يومًا)

ارفع لقطة شاشة واحصل على file_id:

curl https://api.deepseek.com/files \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -F "purpose=user_data" \
  -F "file=@dashboard.png"

ثم أشر إليها في محادثة vision-exp — دون الحاجة لكتلة base64 أو إعادة الرفع في الأدوار اللاحقة:

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash-vision-exp",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "Which metric regressed in this dashboard?"},
        {"type": "file", "file_id": "file-api-xxxx"}
      ]
    }]
  }'

استخدام Python مع حزمة OpenAI SDK — الرفع ثم بدء المحادثة:

from openai import OpenAI

client = OpenAI(api_key="YOUR_KEY", base_url="https://api.deepseek.com")

f = client.files.create(file=open("dashboard.png", "rb"), purpose="user_data")

resp = client.chat.completions.create(
    model="deepseek-v4-flash-vision-exp",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Which metric regressed?"},
            {"type": "file", "file_id": f.id},
        ],
    }],
)
print(resp.choices[0].message.content)

• البديل المضمن: يمكن لكتلة الملف أن تحمل file_data (بتنسيق base64) بدلاً من file_id — وهما حقلان متعارضان تبادليًا؛ ولا يمكن إرفاق filename إلا مع file_data.
• بنية نمط Anthropic: تعمل كتل الملفات نفسها في مسار /messages مع ترويسة anthropic-beta: files-api-2025-04-14.

متى تستخدم الملفات مقابل base64 مقابل روابط URL

FAQ

ذات صلة