DeepSeek Search API: תמחור ודוגמת Python מחיפוש לשליפת תוכן

התיעוד נבדק ב-20 באוקטובר 2026. הדוגמה שלהלן נבדקה מקומית באמצעות נתוני בדיקה קבועים; היא לא הורצה מול נקודות הקצה הפעילות בתשלום.

DeepSeek Search API מעניק ליישום גישה לתוצאות חיפוש באינטרנט. Fetch API המשלים אותו שולף עמוד יחיד בפורמט Markdown. DeepSeek פתחה את שני הממשקים ב-17 באוקטובר 2026, עם חיוב נפרד לפי קריאה. כל אחד מהם עולה $0.75 לכל 1,000 בקשות המחויבות בתשלום לפי המחירון שפורסם בדולר אמריקאי. הם משתמשים במפתח API של DeepSeek ובכתובת הרשמית 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 ומפתח API של DeepSeek עם הרשאות הגישה המתאימות בחשבון. שמרו את המפתח במשתנה סביבה בטרמינל שממנו תריצו את הסקריפט:

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

זו דוגמה קטנה, ולכן היא בוחרת בתוצאה הראשונה. ביישום אמיתי, בחרו את העמוד שמתאים לשאלה, בדקו את הדומיין שלו ואת ההקשר שבו פורסם, ושמרו את הכתובת לצד הטקסט שחולץ. גם תוצאת חיפוש שמדורגת ראשונה צריכה להיות רלוונטית לתשובה שאתם מייצרים.

מבנה הבקשה תואם את תיעוד 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 מבקשת בכוונה 5 תוצאות ומשאירה את שליפת תוכן העמוד לבקשת Fetch שתבוא אחר כך. עיינו בתיעוד Search לפני שתרחיבו את הבקשה בשדות נוספים.

מערך תוצאות ריק פירושו חיפוש שהצליח אך לא מצא התאמות. הדוגמה נעצרת שם. שגיאת HTTP מטופלת בנפרד, וחריגה מזמן ההמתנה עוצרת את הביצוע במקום ליצור אוטומטית בקשה נוספת. ביישום גדול יותר, הגדירו במפורש את מספר הניסיונות החוזרים המותר ואת ההוצאה הנוספת הכרוכה בהם.

Markdown שנשלף הוא חומר ממקור חיצוני. שמרו את כתובת המקור, בדקו אם התוכן עונה על השאלה, והתייחסו להוראות שמוטמעות בעמוד שנשלף כחלק מתוכן העמוד ולא כהוראות ליישום שלכם. אם אתם מעבירים את התוכן למודל שפה, שמרו על ההבחנה הזאת בפרומפט ועל ההפניות למקורות בתשובה שנוצרת.

שאלות נפוצות

האם ה-API של DeepSeek יכול לחפש באינטרנט?

כן. ממשקי Search ו-Fetch העצמאיים מתועדים. קריאה לנקודת קצה רגילה של צ'אט וקריאה לנקודות הקצה האלה לאחזור מידע הן פעולות שונות; פעלו לפי המפרט המתאים לתהליך שאתם בונים.

האם יש מסלול חינמי ל-DeepSeek Search API?

ההודעה המצוטטת מתארת שימוש זמני ללא תשלום בכלים בצד השרת במסגרת שילובים מסוימים של סוכני קוד. היא אינה מבססת מסלול חינמי כללי לכל בקשת Search או Fetch עצמאית. בדקו את עמוד החיוב הנוכחי לפני הרצת אצווה.

האם צריך Fetch אחרי כל חיפוש?

לא. חיפוש עשוי לספק מספיק מידע, במיוחד כאשר מוחזר תוכן שימושי עם need_content: true. Fetch שימושי כשצריך לשלוף בנפרד את העמוד שנבחר.

התחילו במסלול אחזור אחד

DeepSeek Search API מוצא מקורות, ו-Fetch שולף עמוד שנבחר. התחילו בשאילתה אחת, בדקו את התוצאה ואת התוכן, ואז החליטו אם היישום שלכם צריך עמודים נוספים או סיכום שיוצר מודל. לעדכון המודל הנפרד שהוכרז באותו יום, ראו עדכון גרסת המודל מ-17 באוקטובר: מבחני ביצועים ושינויים.