DeepSeek Search API: الأسعار ومثال Python للبحث ثم جلب الصفحة

راجعنا الوثائق في 20 أكتوبر 2026. تحققنا من المثال أدناه محليا باستخدام بيانات اختبار معدة مسبقا؛ ولم نشغله على نقاط النهاية المدفوعة الفعلية.

تتيح DeepSeek Search API للتطبيق الوصول إلى نتائج البحث في الويب. وتجلب واجهة Fetch API المصاحبة لها صفحة واحدة بتنسيق Markdown. أتاحت DeepSeek الواجهتين في 17 أكتوبر 2026، مع رسوم مستقلة لكل استدعاء. وتبلغ تكلفة كل منهما $0.75 لكل 1,000 طلب خاضع للرسوم وفقا لجدول الأسعار المنشور بالدولار الأمريكي. وتستخدمان مفتاح DeepSeek API والعنوان الرسمي api.deepseek.com. المصادر: إعلان الإتاحة، الأسعار.

يوضح هذا الدليل عملية بحث واحدة يليها جلب اختياري لصفحة. وتستخدم الأمثلة خدمة DeepSeek نفسها؛ ولا تصف نقطة نهاية Search أو Fetch تقدمها SeedRouter.

ما الفرق بين DeepSeek Search API وFetch API؟

تعثر Search على صفحات مرشحة. وتقرأ Fetch صفحة اخترتها.

تقبل الواجهتان JSON وتستخدمان مصادقة Bearer. يتضمن طلب البحث المستقل query، ويتضمن طلب جلب الصفحة url. وهما طلبان منفصلان، وليسا إعدادا يضيف الوصول إلى الويب تلقائيا إلى كل عملية إكمال محادثة. ويوثق دليل Search & Fetch الرسمي الواجهتين.

تقبل Search أيضا need_content. وعندما تكون قيمته true، يمكن أن تتضمن نتائج البحث محتوى الصفحات. تحقق من المحتوى المعاد قبل إرسال طلب آخر: إذا كان يحتوي بالفعل على ما تحتاج إليه، فقد لا تحتاج إلى استدعاء Fetch منفصل.

قبل تشغيل مثال Python

تحتاج إلى Python 3، وإمكانية إجراء اتصالات HTTPS صادرة، ومفتاح DeepSeek API لحساب لديه صلاحية الوصول المناسبة. ضع المفتاح في متغير بيئة داخل الطرفية التي تشغل منها البرنامج:

export DEEPSEEK_API_KEY="your-deepseek-api-key"

يستخدم المثال مكتبة Python القياسية، فلا يتطلب تثبيت أي حزمة. وهو يرسل طلب Search واحدا. وإذا وجد نتيجة، يطبع عنوان النتيجة الأولى ورابطها ثم يجلب تلك الصفحة. قد يؤدي تشغيله إلى رسوم؛ ولا يطبع المفتاح أبدا.

مثال Python: ابحث واختر نتيجة ثم اجلب محتواها

احفظ الشيفرة التالية باسم deepseek_search.py. وقبل تشغيلها، غيّر QUERY لتناسب المعلومات التي تحتاج إليها.

import json
import os
import urllib.error
import urllib.request

BASE_URL = "https://api.deepseek.com"
QUERY = "Python documentation pathlib"


def call(path, payload):
    request = urllib.request.Request(
        BASE_URL + path,
        data=json.dumps(payload).encode("utf-8"),
        headers={
            "Authorization": "Bearer " + os.environ["DEEPSEEK_API_KEY"],
            "Content-Type": "application/json",
        },
        method="POST",
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            return json.load(response)
    except urllib.error.HTTPError as error:
        raise RuntimeError(f"DeepSeek returned HTTP {error.code}") from None


def main():
    search = call(
        "/v1/tools/search",
        {"query": QUERY, "count": 5, "need_content": False},
    )
    results = search.get("results", [])
    if not results:
        print("No search results; no Fetch request was made.")
        return

    selected = results[0]
    print(selected.get("title", "Untitled result"))
    print(selected["url"])

    page = call("/v1/tools/fetch", {"url": selected["url"]})
    content = page.get("content", "")
    if not content:
        print("The selected page returned no content.")
        return
    print(page.get("title", ""))
    print(content)


if __name__ == "__main__":
    main()

شغله بالأمر التالي:

python3 deepseek_search.py

هذا مثال صغير، لذلك يختار النتيجة الأولى. أما في تطبيق فعلي، فاختر الصفحة التي تطابق السؤال، وافحص نطاقها وسياق نشرها، واحتفظ بعنوان URL مع النص المستخرج. وحتى النتيجة المتصدرة في البحث يجب أن تكون ذات صلة بالإجابة التي تعدها.

تتبع بنية الطلب مرجع Search ومرجع Fetch لدى DeepSeek. ويمكن لفحص الصياغة البرمجية والاختبارات المحلية ببيانات معدة مسبقا التحقق من طريقة بناء الطلبات ومسارات التنفيذ في البرنامج. لكنها لا تثبت وصول الحساب إلى الخدمة الفعلية، أو سرعة الاستجابة، أو جودة استرجاع المعلومات.

أسعار DeepSeek Search API: متى تحتسب الرسوم؟

السعر المنشور بالدولار الأمريكي هو $0.75 لكل 1,000 طلب ناجح خاضع للرسوم في Search، والسعر نفسه في Fetch. لا تفرض رسوم على بحث لا يعيد نتائج؛ وتحتسب رسوم Fetch عند جلب المحتوى بنجاح. ولا يغير عدد النتائج المطلوب باستخدام count سعر عملية بحث واحدة. راجع جدول الأسعار الحالي للاطلاع على شروط احتساب الرسوم.

للتوضيح، فإن 1,000 عملية بحث خاضعة للرسوم تتبعها 1,000 عملية جلب خاضعة للرسوم ستكلف $1.50 مقابل استرجاع المعلومات. وهذا حساب مبني على الأسعار المذكورة، وليس فاتورة مقاسة أو وعدا بما سيعيده أي استعلام بعينه. أما رموز النموذج المستخدمة لاحقا لتلخيص تلك الصفحات فلها تكلفة منفصلة.

الفترة المجانية المؤقتة أضيق نطاقا. تقول DeepSeek إن استدعاءات Search/Fetch التي يجريها مستخدمو API لديها عبر الأدوات المنفذة على الخادم في DeepSeek Harness وClaude Code وCodex لا تخضع للرسوم مؤقتا. ويبدأ احتساب رسوم هذا الاستخدام في 31 أكتوبر 2026 الساعة 16:00 UTC، أي 1 نوفمبر الساعة 00:00 في بكين. ولا يجعل الإعلان طلبات Python المستقلة في هذا الدليل مجانية للجميع. الإعلان الرسمي.

المعلمات وحالات الإخفاق التي ينبغي مراعاتها

الطول الموثق لاستعلام البحث هو 1–128 محرفا من Unicode. القيمة الافتراضية لـ count هي 10، وهو يقبل قيما ضمن النطاق 1–50. يطلب مثال Python عمدا خمس نتائج ويترك جلب محتوى الصفحة لطلب Fetch لاحق. راجع مرجع Search قبل توسيع الطلب بحقول أخرى.

تعني مصفوفة النتائج الفارغة أن البحث نجح لكن بلا نتائج مطابقة. ويتوقف المثال عند هذه النقطة. أما خطأ HTTP فتتم معالجته على حدة، ويوقف انتهاء المهلة التنفيذ بدلا من إنشاء طلب آخر تلقائيا. وفي التطبيقات الأكبر، حدد بوضوح أي سقف لإعادة المحاولة والإنفاق الإضافي.

محتوى Markdown المجلوب مادة من مصدر خارجي. احتفظ بعنوان URL للمصدر، وافحص ما إذا كان المحتوى يجيب عن السؤال، وتعامل مع التعليمات المضمنة في الصفحة المجلوبة بوصفها محتوى صفحة لا تعليمات لتطبيقك. وإذا مررت المحتوى إلى نموذج لغوي، فحافظ على هذا التمييز في المطالبة واحتفظ بإحالات المصادر في الإجابة الناتجة.

الأسئلة الشائعة

هل تستطيع DeepSeek API البحث في الويب؟

نعم. واجهتا Search وFetch المستقلتان موثقتان. استدعاء نقطة نهاية محادثة عادية واستدعاء نقاط نهاية استرجاع المعلومات عمليتان مختلفتان؛ اتبع المواصفات المناسبة لمسار العمل الذي تبنيه.

هل توجد فئة مجانية في DeepSeek Search API؟

يصف الإعلان المشار إليه استخداما مؤقتا مجانيا لأدوات تنفذ على الخادم ضمن تكاملات محددة لوكلاء البرمجة. لكنه لا ينشئ فئة مجانية عامة لكل طلب مستقل إلى Search أو Fetch. تحقق من صفحة احتساب الرسوم الحالية قبل تشغيل مجموعة طلبات.

هل أحتاج إلى Fetch بعد كل بحث؟

لا. قد يوفر البحث معلومات كافية، خصوصا عند إعادة محتوى مفيد مع need_content: true. وتفيد Fetch عندما تحتاج إلى جلب الصفحة المختارة بشكل منفصل.

ابدأ بمسار واحد لاسترجاع المعلومات

تعثر DeepSeek Search API على المصادر، وتجلب Fetch صفحة مختارة. ابدأ باستعلام واحد، وافحص النتيجة والمحتوى، ثم قرر ما إذا كان تطبيقك يحتاج إلى صفحات إضافية أو ملخص يولده نموذج. وللاطلاع على تحديث النموذج المنفصل الذي أعلن في اليوم نفسه، راجع تحديث نسخة الأوزان في 17 أكتوبر: الاختبارات والتغييرات.