كم تبلغ تكلفة API باقة DeepSeek الكاملة؟ حساب Search وFetch وOCR وASR وTTS جميعًا: فاتورة كاملة لـ4 سيناريوهات

كم تبلغ تكلفة API باقة DeepSeek الكاملة؟ حساب Search وFetch وOCR وASR وTTS جميعًا: فاتورة كاملة لـ4 سيناريوهات

ملخص: تحتسب واجهات API لحزمة DeepSeek الكاملة رموز النموذج (Token) واستدعاء الأدوات بشكل منفصل. ينبغي حساب التكلفة الكاملة بنداً بنداً وفق عدد مرات البحث وعدد صفحات الملفات وحجم معالجة الصوت ومعدل إصابة ذاكرة التخزين المؤقت.

الخلاصة أولاً: وفقاً لوثيقة الأسعار الرسمية باللغة الصينية لـ DeepSeek بتاريخ 15 نوفمبر 2026، فإن Search وFetch كلاهما بسعر ¥5 لكل 1000 طلب ناجح، وتحليل الملفات وOCR كلاهما بسعر ¥1.5 لكل 1000 صفحة، وسعر ASR محدود المدة هو ¥0.39 لكل ساعة، وسعر TTS محدود المدة هو ¥1.5 لكل 10000 حرف محتسب. أسعار الأدوات لكل وحدة منخفضة جداً، لكن فاتورة مهمة Agent متصلة بالإنترنت تكون عادةً محكومة بـ Token النموذج. وبحساب مهمة بحث تتضمن «بحثين، و3 عمليات جلب، و20 ألف Token إدخال، و3000 Token إخراج»، تكون تكلفة 1000 مهمة في فترة غير الذروة نحو ¥57، وفي فترة الذروة نحو ¥89؛ وعندما تبلغ نسبة إصابة ذاكرة التخزين المؤقت للإدخال 80%، يمكن أن تنخفض التكلفة في فترة غير الذروة إلى نحو ¥41.32. لذا، عند إعداد الميزانية، احسب على أساس «المهمة الكاملة»؛ فسعر طلب API الواحد ليس إلا بنداً واحداً ضمنها.

نفصل فيما يلي أولاً بنية احتساب تكاليف النموذج وتكاليف الأدوات، ثم نسرد بنداً بنداً أسعار Search وFetch وتحليل الملفات وOCR وASR وTTS ووحدات الاحتساب الخاصة بكل منها. بعد ذلك نعرض الخوارزمية الكاملة عبر 4 سيناريوهات بافتراضات ثابتة، ونوضح كيف يؤثر البحث العميق والسياق الطويل وحدود المعدل في الفاتورة. وأخيراً نقدّم مجموعة من شيفرة تسجيل التكاليف القابلة لإعادة الاستخدام مباشرة، ونقارن بين البحث المدمج في النموذج وواجهات Search / Fetch المستقلة، وطريقة اختيار المناسب بينها.

deepseek-full-suite-api-pricing-search-fetch-ocr-asr-tts-ar-image-0

Table of Contents

To Know: مصطلحات فوترة API في حزمة DeepSeek الكاملة

المصطلح الشرح
Token وحدة القياس التي يستخدمها النموذج عند معالجة النص، وتُحتسب رسوم النموذج على أساس كل مليون Token
رموز الإدخال كل المحتوى الذي يدخل إلى سياق النموذج ويشارك في الاستدلال، بما في ذلك الموجهات ومحتوى الملفات ونتائج البحث
رموز الإخراج المحتوى الذي يولّده النموذج، وتُحتسب عملية الاستدلال في وضع التفكير ضمن رموز الإخراج أيضًا
Context Cache إعادة استخدام سياق سبق معالجته، ما يقلل تكلفة المدخلات المكررة
Cache Hit نجاح إعادة استخدام محتوى الإدخال من ذاكرة التخزين المؤقت، فيُحتسب بسعر وحدة «إصابة الذاكرة» الأقل
ساعات الذروة / الخمول فئتان سعريتان يعتمدهما DeepSeek حسب توقيت بكين، إذ يساوي سعر الخمول نصف سعر الذروة
Search API الاستعلام عن صفحات الويب بكلمات مفتاحية، وإرجاع نتائج بحث منظمة
Fetch API جلب صفحة ويب محددة وإرجاع محتواها النصي
البحث المدمج في النموذج تعريف أداة بحث داخل طلب المحادثة، ليقرر النموذج البحث بنفسه ويتولى الخادم تنفيذه نيابةً عنه
QPS عدد الطلبات المسموح بمعالجتها في الثانية
OCR التعرف على النصوص من الصور أو المستندات
ASR تحويل الكلام إلى نص
TTS تحويل النص إلى كلام
أحرف الفوترة وحدة قياس TTS، ويُحتسب الحرف الصيني الواحد كحرفَي فوترة
Tool Usage استهلاك الفوترة الناتج عن استدعاء النموذج أو البرنامج لأدوات خارجية فعليًا

1 كيف تُحتسب رسوم واجهة API للحزمة الكاملة من DeepSeek فعليًا

1.1 نوعا الفواتير في واجهة API للحزمة الكاملة من DeepSeek: رسوم النموذج ورسوم الأدوات

في 13 نوفمبر 2026، أتاحت DeepSeek قدرات تطبيق App الكامنة، مثل البحث عبر الإنترنت، والبحث مع التفكير العميق، وقراءة الروابط، وإدخال الملفات، وOCR، وASR، وTTS، والتحقق الأمني، على شكل واجهة API. ومن حيث الفوترة، تُحسب هذه القدرات واستنتاج النموذج بشكل منفصل. ويمكن تلخيص ذلك بالمعادلة التالية:

التكلفة الإجمالية = تكلفة إدخال النموذج (إصابة الذاكرة المؤقتة + عدم إصابة الذاكرة المؤقتة)
       + تكلفة إخراج النموذج (بما في ذلك Token التفكير)
       + تكلفة استدعاء الأدوات (Search / Fetch / البحث عن الصور)
       + تكلفة معالجة الملفات والصوت (عدد الصفحات المحللة / عدد صفحات OCR / مدة الصوت / أحرف TTS)

قد يُنتج طلب سؤال وجواب واحد في الجولة نفسها كل بند من البنود أعلاه في الوقت نفسه. على سبيل المثال، بعد تفعيل البحث مع التفكير العميق في محادثة، سيولّد النموذج عبارات بحث عدة مرات، ويفتح عدة صفحات ويب، ثم يدمج محتوى الصفحات في السياق لمواصلة الاستنتاج. وينتج هذا الطلب الواحد رسوم البحث والجلب، كما ينتج كمية كبيرة من Token الإدخال بسبب دخول نص الصفحة إلى السياق، وتُحتسب عملية التفكير أيضًا ضمن Token الإخراج.

deepseek-full-suite-api-pricing-search-fetch-ocr-asr-tts-ar-image-1

1.2 أسعار نماذج DeepSeek Flash وPro

فيما يلي الأسعار المعلنة في وثيقة الأسعار الرسمية من DeepSeek بتاريخ 15 نوفمبر 2026، والعملة هي اليوان الصيني، والوحدة لكل مليون Token.

النموذج إصابة الذاكرة المؤقتة (خارج وقت الذروة / وقت الذروة) عدم إصابة الذاكرة المؤقتة (خارج وقت الذروة / وقت الذروة) الإخراج (خارج وقت الذروة / وقت الذروة) حد التزامن
DeepSeek-V4.1-Flash ¥0.02 / ¥0.04 ¥1 / ¥2 ¥4 / ¥8 2500
DeepSeek-V4-Pro ¥0.15 / ¥0.30 ¥4.5 / ¥9 ¥13.5 / ¥27 500

وقت الذروة هو من 09:00 إلى 12:00 ومن 14:00 إلى 18:00 بتوقيت بكين، من الاثنين إلى الجمعة، باستثناء العطلات الرسمية الصينية؛ أما بقية الأوقات (بما فيها عطلة نهاية الأسبوع والعطلات الرسمية طوال اليوم) فهي خارج وقت الذروة. ويبلغ طول السياق لدى النموذجين 1M، والحد الأقصى لطول الإخراج 384K؛ ويدعم Flash فهم الصور، بينما لا يدعمه Pro.

كما يؤثر اختيار النموذج في توفّر الأدوات. في هذا الإعلان، تُحمّل التكاملات الكاملة للأدوات على مستوى المحادثة (البحث عبر الإنترنت، والبحث مع التفكير العميق، وقراءة الروابط، وتحليل الملفات، وفهم الصور، والتحقق الأمني) على deepseek-flash (DeepSeek-V4.1-Flash). وعند التخطيط لتطبيق يحتاج إلى أدوات مدمجة، ينبغي بناء نموذج التكلفة على أساس Flash.


2 كم تبلغ تكلفة كل من Search وFetch وOCR وASR وTTS في واجهات API لحزمة DeepSeek الكاملة؟

يعرض الجدول أدناه أسعار أدوات DeepSeek الرسمية (15 نوفمبر 2026، باليوان الصيني). نضع سعر القائمة والعرض محدود المدة في عمودين منفصلين؛ وبعد انتهاء العرض محدود المدة، ستحتاج إلى إعادة احتساب الميزانية بسعر القائمة.

القدرة وحدة الفوترة سعر القائمة عرض محدود المدة السعر المحوّل لكل مرة / وحدة
البحث Search 1000 طلب ناجح ¥5 ¥5 ¥0.005 / مرة
Fetch جلب صفحات الويب 1000 طلب ناجح ¥5 ¥5 ¥0.005 / مرة
تحليل الملفات 1000 صفحة ¥1.5 ¥1.5 ¥0.0015 / صفحة
OCR 1000 صفحة ¥1.5 ¥1.5 ¥0.0015 / صفحة
ASR ساعة صوتية واحدة ¥0.78 ¥0.39 أقل من ثانية تُحسب ثانية واحدة
TTS 10000 حرف محتسب ¥3 ¥1.5 كل حرف صيني يُحسب حرفين

2.1 آلية فوترة Search و Fetch في DeepSeek

يُحتسب البحث Search المستقل حسب الطلبات الناجحة: لا يُعدّ الطلب ناجحًا إلا إذا كان HTTP 200 وكانت مصفوفة results غير فارغة. يمكن للطلب الواحد أن يعيد من 1 إلى 50 نتيجة (count قيمته الافتراضية 10)، وسعر النتيجة الواحدة هو نفسه سعر الخمسين، لذا جلب نتائج كثيرة في طلب واحد أوفر من عدة طلبات قليلة. أما Fetch المستقل فيشترط HTTP 200 مع إرجاع نص الصفحة بنجاح؛ ولا تُفرض أي رسوم على الفشل أو انتهاء المهلة أو عدم وجود نتائج.

أما البحث المدمج في النموذج فله معيار احتساب مختلف. البحث النصي المدمج يُحتسب حسب عدد مصطلحات الاستعلام المنفذة فعليًا، فاستدعاء أداة واحدة يحمل 3 مصطلحات استعلام يُحتسب 3 مرات؛ والبحث المصوّر المدمج يُحتسب حسب عدد الصور المعادة وعدد المناطق المحددة؛ وجلب صفحات الويب المدمج يُحتسب حسب عدد الصفحات التي جُلبت بنجاح. لذلك، عند تفعيل البحث داخل المحادثة، فإن إنفاق رسوم بحث عدة مرات في جولة أسئلة وأجوبة واحدة يُعدّ أمرًا طبيعيًا.

2.2 فوترة تحليل الملفات و OCR في DeepSeek حسب الصفحة

يتم تحليل الملفات عبر Files API: ترفع الملف، فيحلّله الخادم، ثم يعيد file_id، ويكفي أن تشير إلى file_id داخل المحادثة. وتُحتسب الفوترة حسب عدد الصفحات التي حُلّلت بنجاح، بواقع ¥1.5 لكل 1000 صفحة. وعند الإشارة لاحقًا إلى الملف نفسه الذي حُلّل مسبقًا داخل المحادثة، لا تُفرض رسوم تحليل مرة أخرى، لكن محتوى الملف يُحتسب في كل مرة يدخل فيها السياق ضمن توكنات الإدخال.

كما يؤثر وضع التحليل على استهلاك التوكنات. فالوضع text_recognition يمنح النموذج نصًا صافيًا فقط، أما rich_layout_recognition فيقصّ الرسوم البيانية إلى صور ويسلّمها للنموذج مع النص، وهو مناسب للتقارير المالية وملفات PPT، لكنه يزيد توكنات الصور. ويمكن رفع ملفات مثل XLSX وCSV وTXT وMD وJSON وEPUB بصفتها user_data وتحويلها إلى Markdown، وهذه الأنواع من الرفع لا تُفرض عليها رسوم تحليل.

أما OCR فهو واجهة مستقلة (/v1/tools/ocr)، وسعرها أيضًا ¥1.5 لكل 1000 صفحة، وتُحتسب حسب عدد الصفحات التي جرى التعرّف عليها بنجاح، ولا تُفرض رسوم على الفشل أو انتهاء المهلة. والغرض من الاثنين مختلف: فـ OCR يقتصر على استخراج النص ومعلومات الموضع، في حين أن تحليل الملفات يرسل النتيجة مباشرة إلى سياق النموذج ليفهمها.

2.3 تكلفة الخدمات الصوتية في DeepSeek ASR وTTS

تأتي خدمة ASR (المسار /v1/tools/asr) بسعر قائمة يبلغ 0.78 يوان لكل ساعة صوت، وهي معروضة حاليًا بخصم 50% لفترة محدودة ليصبح السعر 0.39 يوان، مع احتساب أي مقطع أقل من ثانية واحدة كثانية كاملة. تعتمد الخدمة على رفع الملف كاملًا والقيام بعملية تعرّف غير متدفقة (non-streaming)، إذ يبلغ الحد الأقصى لطول الملف الصوتي الواحد 120 ثانية وحجمه 8 ميغابايت، وتدعم صيغتي 16-bit PCM WAV وOgg Opus، مع حد أقصى 50 طلبًا متزامنًا لكل حساب. أما التسجيلات الطويلة فتحتاج إلى تقطيع مسبق، وكل جزء متبقٍّ أقل من ثانية في نهاية كل مقطع يُحتسب كثانية كاملة على حدة، وكلما زاد تقطيع الملف تراكمت هذه الاحتسابات الجزئية.

أما خدمة TTS (المسار /v1/tools/tts، وتدعم أيضًا التوليد المتدفق عبر WebSocket) فسعر القائمة هو 3 يوانات لكل 10000 حرف خاضع للفوترة، والسعر لفترة محدودة 1.5 يوان. تُحتسب كل كلمة صينية على أنها حرفان خاضعان للفوترة، بينما تُحتسب الحروف الإنجليزية والأرقام والمسافات كحرف واحد لكل منها، وبحد أقصى 10000 حرف خاضع للفوترة في الطلب الواحد. وبالحساب، فإن 100 ألف حرف خاضع للفوترة يساوي تقريبًا 50 ألف كلمة صينية، لذا يجب مضاعفة ميزانية المحتوى الصيني أولًا (×2).


3 تقدير تكاليف واجهات DeepSeek الكاملة في أربعة سيناريوهات

تستند الحالات الأربع التالية جميعها إلى الأسعار المعلنة والافتراضات الثابتة، إذ إن عدد الاستدعاءات وحجم استخدام الـ Tokens قيم افتراضية، وهي بذلك تُعد تقديرات سيناريوية توضح طريقة الحساب فقط، أما الفاتورة الفعلية فتُعتمد على حقول الفوترة التي يعيدها الخادم.

3.1 السيناريو الأول: 1000 مهمة بحث عبر الإنترنت (¥57 في غير أوقات الذروة / ¥89 في أوقات الذروة)

الافتراض: استخدام DeepSeek-V4.1-Flash؛ كل مهمة تتضمن كلمتي استعلام بحث ناجحتين، و3 عمليات جلب ناجحة لصفحات ويب، و20000 رمز إدخال لم تُصَب في ذاكرة التخزين المؤقت، و3000 رمز إخراج.

البند صيغة الحساب غير أوقات الذروة (¥/مهمة) أوقات الذروة (¥/مهمة)
رموز الإدخال 20000 ÷ 1000000 × سعر الوحدة 0.020 0.040
رموز الإخراج 3000 ÷ 1000000 × سعر الوحدة 0.012 0.024
البحث 2 × ¥0.005 0.010 0.010
الجلب 3 × ¥0.005 0.015 0.015
إجمالي المهمة الواحدة — 0.057 0.089
إجمالي 1000 مهمة المهمة الواحدة × 1000 ¥57 ¥89

تتضاعف تكلفة رموز النموذج في أوقات الذروة، بينما يبقى سعر البحث والجلب دون تغيير، لذا يرتفع إجمالي الفاتورة من ¥57 إلى ¥89، أي بزيادة تقارب 56%. وفي هذه المهمة تشكّل تكلفة النموذج نحو 56% من فاتورة غير أوقات الذروة (¥32 / ¥57)، ما يعني أن الجزء الأكبر في وكيل البحث عبر الإنترنت يظل في الرموز. وإن أبسط وسيلة لخفض التكلفة هي تأجيل المهام الدفعية التي يمكن تأخير تنفيذها إلى غير أوقات الذروة.

3.2 السيناريو الثاني: كم يمكن أن يوفر تحقيق نسبة إصابة 80% في ذاكرة التخزين المؤقت للإدخال؟

الافتراض: الشروط مماثلة للسيناريو الأول (فترة الخمول)، لكن من بين 20000 رمز إدخال، هناك 16000 رمز يصيب ذاكرة التخزين المؤقت و4000 رمز لا يصيبها.

  • إدخال أصاب ذاكرة التخزين المؤقت: 16000 ÷ 1000000 × ¥0.02 = ¥0.00032
  • إدخال لم يصب ذاكرة التخزين المؤقت: 4000 ÷ 1000000 × ¥1 = ¥0.004
  • الإخراج: 3000 ÷ 1000000 × ¥4 = ¥0.012
  • البحث + الجلب: ¥0.010 + ¥0.015 = ¥0.025
  • إجمالي المرة الواحدة ¥0.04132، وإجمالي 1000 مرة ¥41.32

مقارنةً بـ ¥57 في السيناريو الأول، يوفر ¥15.68، أي نحو 27.5%. تؤثر ذاكرة التخزين المؤقت في تكاليف الإدخال فقط: ينخفض الإدخال من ¥0.020 إلى نحو ¥0.0043، بينما تبقى تكاليف الإخراج والأدوات دون تغيير تمامًا. كلما ارتفعت نسبة إصابة ذاكرة التخزين المؤقت، اقتربت الفاتورة من الحد الأدنى «الإخراج + الأدوات»، وعند هذه النقطة يتطلب مواصلة خفض التكلفة الاعتماد على تقليل عدد مرات البحث والتحكم في طول الإخراج.

deepseek-full-suite-api-pricing-search-fetch-ocr-asr-tts-ar-image-2

3.3 السيناريو الثالث: المعالجة الدفعية لـ 5000 صفحة من مستندات المؤسسة

الافتراض: خلال فترة خمول Flash؛ تُحلَّل مستندات 5000 صفحة مرة واحدة فقط؛ ويستهلك التحليل اللاحق ما مجموعه 10 ملايين Token إدخال غير موجودة في ذاكرة التخزين المؤقت، ومليون Token إخراج.

  • تحليل الملفات: 5000 ÷ 1000 × ¥1.5 = ¥7.50
  • إدخال النموذج: 10000000 ÷ 1000000 × ¥1 = ¥10.00
  • إخراج النموذج: 1000000 ÷ 1000000 × ¥4 = ¥4.00
  • الإجمالي ¥21.50

تمثل تكلفة التحليل نحو 35% فقط. إذا أُدخلت الدفعة نفسها من الملفات كاملة إلى السياق مرة بعد أخرى في محادثات متعددة الجولات، فستزداد Token الإدخال أضعافًا، بينما لن تزداد تكلفة التحليل. العامل الحاسم في سيناريو المستندات الكبيرة هو التحكم في “عدد مرات إدخال محتوى الملفات إلى السياق”.

3.4 السيناريو الرابع: 10 ساعات من التعرف على الكلام + 100 ألف حرف محتسب في TTS

الافتراض: استخدام سعر الخصم الحالي لفترة محدودة (50%)؛ ASR لـ 10 ساعات من الصوت، وTTS بـ 100000 حرف محتسب.

  • ASR: 10 × ¥0.39 = ¥3.90
  • TTS: 100000 ÷ 10000 × ¥1.5 = ¥15.00
  • الإجمالي ¥18.90

تشمل هذه التكلفة خدمات الصوت فقط. عندما يُسلَّم النص الناتج عن التحويل الصوتي إلى نموذج المحادثة للتلخيص أو الإجابة عن الأسئلة، تُحتسب Token النموذج بشكل منفصل. بحسب سعر القائمة المعلن، تكلفة نفس الاستخدام هي 10 × ¥0.78 + 10 × ¥3 = ¥37.80. وبعد انتهاء فترة الخصم، ستتضاعف ميزانية الصوت. بالإضافة إلى ذلك، يجب تقسيم 10 ساعات من الصوت إلى 300 مقطع على الأقل بحد أقصى 120 ثانية، مع جدولة تدعم 50 عملية متزامنة.

4 ما العوامل التي ترفع فاتورة API لمجموعة DeepSeek الكاملة

4.1 البحث بالتفكير العميق ينفّذ عدة استعلامات في مرة واحدة

يمكن للبحث بالتفكير العميق استدعاء الأدوات حتى نحو 20 مرة قبل تقديم الإجابة، وتُحتسب الفوترة وفقًا لتراكم الإجراءات الفعلية. في تفاصيل الفوترة الرسمية، هناك عدة قواعد أساسية:

  • عندما تتضمن عملية Search واحدة 3 استعلامات وكلها تعيد نتائج، تُحتسب 3 عمليات بحث
  • إذا أعاد البحث عن الصور 3 صور، تُحتسب 3 مرات، وإذا حدد النموذج بعد ذلك منطقتين داخل الصور، تُحتسب مرتان إضافيتان
  • فتح صفحة ويب واحدة تتطلب جلبًا عبر الإنترنت بنجاح يُحتسب كعملية Fetch واحدة، وإعادة فتح الصفحة نفسها لا تُحتسب مرة أخرى
  • تنفيذ find_in_page على صفحة مفتوحة لا يُحتسب بشكل منفصل، ولا يُحتسب Search إذا لم يعيد نتائج
  • عند تفعيل أمان محتوى النموذج، قد تظل بعض صفحات الويب قابلة للاحتساب إذا نجح الجلب في الخلفية، حتى لو ظهرت بالحالة url_not_allowed أو unavailable

عند حساب الاستخدام، استخدم حقول الفوترة server_tool_use.tool_search وtool_fetch وtool_image_search. إن web_search_requests وweb_fetch_requests يعرضان فقط عدد الكتل المُعادة، وقد يتضمنان طلبات فاشلة؛ والحساب بناءً عليهما سيقدّر التكلفة بأعلى من الواقع.

4.2 السياق الطويل وإدخال الملفات المتكررة

تدخل نتائج البحث ونصوص صفحات الويب والملفات التي جرى تحليلها إلى السياق. تراعي أداة قراءة الروابط 10 عناوين URL مختلفة كحد أقصى في آخر رسالة من المستخدم؛ وعند قراءة عدة صفحات ويب في وقت واحد، تقل المساحة المتاحة لكل صفحة من السياق، لكن إجمالي كمية الإدخال يبقى كبيرًا. في الجلسات الطويلة، يُحمَل المحتوى التاريخي في كل جولة، وتتراكم رموز الإدخال مع تتابع الجولات.

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

4.3 حدود معدل الطلبات في المهام الدفعية

الحد على مستوى الحساب لعملية Search المستقلة هو 100 QPS، ولعملية Fetch هو 25 QPS، وهذه حصة الحساب بأكمله، وتتشاركها مفاتيح API المتعددة. يخضع Fetch أيضًا لحد QPS على مستوى النطاق الهدف، لذا فإن الجلب المركّز من الموقع نفسه يزيد احتمال الوصول إلى 429. توصيات معالجة الأخطاء:

  1. 408 و429 و5xx: أعد المحاولة بعد تراجع أُسّي، ووزّع طلبات النطاق نفسه على فترات
  2. 402: الرصيد غير كافٍ؛ عالج رصيد الحساب أولاً
  3. أي 4xx أخرى (مثل خطأ في المعلمات): صحح الطلب ثم أعد إرساله؛ إعادة المحاولة لا تنفع

الطلبات الفاشلة لا تُحتسب، لذا لا تزيد إعادة المحاولة نفسها من تكلفة الأدوات، لكنها تطيل مدة المهمة. في المهام الكبيرة، استنتج وقت الإنجاز بالاعتماد على حد Fetch البالغ 25 QPS.


5 كيف تصمم ميزانية تكلفة معقولة لـ DeepSeek Agent

5.1 سجل تكاليف API لحزمة DeepSeek الكاملة: بداية سريعة

في بيئة الإنتاج، يجب على الأقل تسجيل كل من: توكنات الإدخال المطابقة للذاكرة المؤقتة (cache hit)، وتوكنات الإدخال غير المطابقة (cache miss)، وتوكنات الإخراج، وعدد مرات Search، وعدد مرات Fetch، وعدد مرات البحث عن الصور، وعدد صفحات تحليل المستندات، ومدة الصوت، وعدد الأحرف المحتسبة في TTS. الدالة التالية تقرأ حقول usage مباشرة وتحسب تكلفة الطلب الواحد، ويمكن ربطها بعد كل طلب لكتابة السجل.

# تقدير تكلفة حزمة DeepSeek الكاملة (بال يوان صيني، الأسعار الرسمية 2026-11-15)
FLASH = {"cache_hit": 0.02, "cache_miss": 1.0, "output": 4.0}  # ¥/مليون توكن خارج وقت الذروة
TOOL = {"search": 0.005, "fetch": 0.005, "image_search": 0.005}  # ¥/مرة

def estimate_cost(usage: dict, peak: bool = False) -> dict:
    k = 2 if peak else 1  # سعر وقت الذروة ضعف سعر خارج وقت الذروة، وسعر الأدوات لا يتغير
    stu = usage.get("server_tool_use", {})
    model = (usage.get("cache_read_input_tokens", 0) * FLASH["cache_hit"]
             + usage.get("input_tokens", 0) * FLASH["cache_miss"]
             + usage.get("output_tokens", 0) * FLASH["output"]) / 1e6 * k
    tools = (stu.get("tool_search", 0) * TOOL["search"]
             + stu.get("tool_fetch", 0) * TOOL["fetch"]
             + stu.get("tool_image_search", 0) * TOOL["image_search"])
    return {"model": round(model, 5), "tools": round(tools, 5),
            "total": round(model + tools, 5)}

# إعادة إنتاج السيناريو الثاني: 16000 إصابة في الذاكرة المؤقتة + 4000 عدم إصابة + 3000 إخراج + 2 بحث + 3 جلب
print(estimate_cost({"cache_read_input_tokens": 16000, "input_tokens": 4000,
                     "output_tokens": 3000,
                     "server_tool_use": {"tool_search": 2, "tool_fetch": 3}}))
# {'model': 0.01632, 'tools': 0.025, 'total': 0.04132}

تُعالج تكلفة البحث عن الصور هنا بسعر Search نفسه؛ يرجى التحقق من الوثائق الرسمية قبل الإطلاق. من حيث أبعاد الميزانية، تناسب منتجات الأسئلة والأجوبة التسجيل “حسب طلب المستخدم”، بينما تناسب الوكلاء متعددة الخطوات وDeep Research والأتمتة الدفعية التسجيل “حسب دورة حياة المهمة”، أي تجميع كل استدعاءات النماذج والأدوات داخل المهمة نفسها تحت task_id واحد.

5.2 متى تختار البحث المدمج في DeepSeek، ومتى تختار واجهات Search / Fetch المستقلة

البُعد البحث المدمج في النموذج (deepseek_web_search / read_url) واجهات Search / Fetch المستقلة
تعقيد التطوير منخفض؛ يتولى الخادم البحث والجلب وتجميع السياق أعلى؛ يتعين عليك تنسيق حلقة الأدوات بنفسك
التحكم في سير العمل النموذج يقرر عدد مرات البحث والصفحات التي يقرأها المطوّر يتحكم بدقة في كل استدعاء
أساس الفوترة حسب عدد مصطلحات الاستعلام وعدد الصور وعدد الصفحات التي جُلبت بنجاح حسب عدد طلبات HTTP الناجحة
إمكانية التنبؤ بالتكلفة تذبذب كبير؛ قد يصل البحث العميق إلى نحو 20 استدعاء أداة مرتفعة؛ عدد الاستدعاءات يحدده الكود
السيناريوهات المناسبة مساعد المحادثة، وإعادة إنتاج تجربة التطبيق بسرعة RAG، والجمع بالدفعات، والوكيل ذو سير العمل الثابت

عندما تحتاج إلى إطلاق منتج محادثة بسرعة، يوفر البحث المدمج قدرًا كبيرًا من العمل الهندسي؛ أما عندما تريد تثبيت تكلفة المهمة الواحدة ضمن نطاق محدد، أو تريد التصفية قبل الجلب، فإن الواجهات المستقلة أنسب. ويمكن الجمع بين الاثنين أيضًا: استخدام الأدوات المدمجة في المسار الرئيسي للمحادثة، والواجهات المستقلة في الخلفية لجمع البيانات بالدفعات.

5.3 تكامل DeepSeek Search / Fetch والأسعار على APIYI

أطلقت APIYI في 21 أكتوبر 2026 واجهات الأدوات المستقلة الخاصة بـ DeepSeek وهما deepseek-search وdeepseek-fetch، عبر المسارين POST /v1/tools/search وPOST /v1/tools/fetch. لا تستهلك هذه الواجهات رموز النموذج (Tokens)، بل تُحتسب رسومها حسب عدد الاستدعاءات الناجحة، وهي متاحة في مجموعتي default وsvip، بينما لا تستطيع الرموز المميزة في مجموعة ClaudeCode استدعاءها مباشرة. بالنسبة للبحث المدمج في النموذج الذي تستدعيه العملاء مثل DeepSeek Harness وClaude Code، لا يزال التوافق على APIYI قيد التخطيط في المراحل اللاحقة، والمتاح حاليًا هو Search / Fetch المستقلان.

فيما يلي الأسعار المنشورة في وثائق APIYI، والعملة هي الدولار الأمريكي:

العنصر السعر الرسمي المذكور في الوثائق سعر APIYI الداخلي ما يعادله بعد مكافأة 20% ما يعادله بعد مكافأة 10%
Search / 1000 عملية $0.75 $0.90 $0.75 نحو $0.82
Fetch / 1000 عملية $0.75 $0.90 $0.75 نحو $0.82

وبحسب حجم الأدوات في السيناريو الأول (1000 عملية Search + 3000 عملية Fetch) نحسب: الرسوم الداخلية (1000 + 3000) ÷ 1000 × $0.90 = $3.60؛ وعند تطبيق مكافأة 20% على كامل الاستهلاك يصبح المكافئ $3.60 ÷ 1.20 = $3.00؛ ومع مكافأة 10% يكون نحو $3.27. تُسعّر DeepSeek الرسمية باليوان الصيني، لذا عند مقارنة التكلفة الفعلية يجب توحيد العملة وسعر الصرف وشروط مكافآت الشحن، والمرجع النهائي هو السعر المعروض في لوحة تحكم الحساب.

مثال استدعاء مبسّط (حقول الطلب وفقًا لوثائق APIYI):

import requests

BASE_URL = "https://api.apiyi.com/v1"  # واجهة APIYI الموحدة
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.post(f"{BASE_URL}/tools/search", headers=headers,
                     json={"model": "deepseek-search",
                           "query": "DeepSeek API 价格", "count": 10})
print(resp.json())
عرض التنفيذ الكامل: البحث أولاً ثم الجلب، مع إعادة المحاولة والتراجع عند 429 وعدّ العمليات
import time
import requests

BASE_URL = "https://api.apiyi.com/v1"  # نقطة دخول APIYI المتوافقة مع OpenAI
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
RETRY_CODES = {408, 429, 500, 502, 503, 504}

def call_tool(path: str, payload: dict, max_retry: int = 4) -> dict | None:
    """استدعاء واجهة الأداة؛ الأخطاء القابلة لإعادة المحاولة تُعيد المحاولة بتراجع أُسّي، والطلبات الفاشلة لا تُحتسب في الفوترة"""
    for i in range(max_retry):
        r = requests.post(f"{BASE_URL}{path}", headers=HEADERS,
                          json=payload, timeout=60)
        if r.status_code == 200:
            return r.json()
        if r.status_code == 402:
            raise RuntimeError("余额不足,请先充值")
        if r.status_code in RETRY_CODES:
            time.sleep(2 ** i)  # 1s, 2s, 4s, 8s
            continue
        raise ValueError(f"请求参数错误: {r.status_code} {r.text}")
    return None

def research(query: str, fetch_top: int = 3) -> dict:
    stats = {"search": 0, "fetch": 0}
    result = call_tool("/tools/search",
                       {"model": "deepseek-search", "query": query, "count": 10})
    items = (result or {}).get("results", [])
    if items:
        stats["search"] += 1  # لا تُحتسب التكلفة إلا عند وجود نتائج غير فارغة
    pages = []
    for item in items[:fetch_top]:  # نجلب فقط الصفحات التي نحتاج فعلاً إلى قراءة نصها الأصلي
        page = call_tool("/tools/fetch",
                         {"model": "deepseek-fetch", "url": item.get("url")})
        if page:
            stats["fetch"] += 1
            pages.append(page)
        time.sleep(0.05)  # ضبط الإيقاع لتجنّب حد Fetch البالغ 25 طلبًا في الثانية وحدود النطاق
    return {"pages": pages, "billing": stats}

if __name__ == "__main__":
    out = research("DeepSeek 全家桶 API 计费规则")
    print(out["billing"])  # على سبيل المثال {'search': 1, 'fetch': 3}

🚀 بداية سريعة: سجّل عبر APIYI على apiyi.com لتحصل على رصيد تجريبي، ثم شغّل Search / Fetch بدفعات صغيرة من الطلبات أولاً، وبعدها احسب ميزانيتك الفعلية بناءً على عدد الاستدعاءات الحقيقي المسجّل في السجلات.


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

س1: ما هي بنود التسعير التي تشملها واجهات API لحزمة DeepSeek الكاملة؟

تشمل رموز النموذج (Token: الإدخال المطابق للذاكرة المؤقتة، والإدخال غير المطابق، والإخراج) ورسوم الأدوات (Search وFetch والبحث عن الصور وتحليل الملفات وOCR وASR وTTS). أما التحقق الأمني والبحث داخل الصفحة `find_in_page` فلم تُدرج لهما أسعار منفصلة في جدول الأسعار المنشور.

س2: ما الفرق في الفوترة بين واجهة Search المستقلة والبحث المدمج في النموذج؟

واجهة Search المستقلة تُحتسب مرة واحدة لكل طلب HTTP ناجح، فلو أعادت 50 نتيجة تُحتسب مرة واحدة فقط. أما البحث المدمج في النموذج فيُحتسب حسب عدد كلمات الاستعلام الفعلية، فاستدعاء واحد يتضمن 3 كلمات استعلام يُحتسب 3 مرات. التطوير بالطريقة المدمجة أسهل، والطريقة المستقلة تتيح تحكماً أكبر في التكلفة.

س3: ما تاريخ هذه الأسعار، وهل تتغير العروض المؤقتة؟

أُخذت الأسعار في هذا المقال من وثيقة الأسعار الرسمية الصينية لـ DeepSeek، بتاريخ 15 نوفمبر 2026. وخدمتا ASR وTTS بخصم 50% لفترة محدودة حالياً، وبعد انتهائها تعودان إلى ¥0.78 لكل ساعة و¥3 لكل 10000 حرف محتسب على الترتيب. لذا يُنصح بترك هامش في الميزانية طويلة الأجل بناءً على الأسعار المعلنة.

س4: هل تتضاعف الفاتورة مباشرة في ساعات الذروة؟

جزء رموز النموذج فقط هو الذي يتضاعف، أما أسعار الأدوات فلا تختلف حسب الوقت. في السيناريو الأول ارتفعت الفاتورة الإجمالية من ¥57 إلى ¥89، أي بنسبة زيادة نحو 56%. وكلما ارتفعت نسبة رسوم الأدوات في المهمة، قلّت نسبة الزيادة في ساعات الذروة.

س5: كيف يمكن استدعاء DeepSeek Search وFetch بسرعة عبر API؟

1. سجّل في APIYI على apiyi.com وأنشئ رمزاً (Token) ضمن مجموعة default أو svip
2. اضبط base_url على `https://api.apiyi.com/v1`
3. استخدم الكود الوارد في هذا المقال لطلب `/tools/search` و`/tools/fetch`، باسمي النموذج `deepseek-search` و`deepseek-fetch`

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

س6: هل يتكرر تحصيل الرسوم عند تكرار السؤال عن ملف بعد تحليله؟

رسم التحليل يُحتسب مرة واحدة فقط، وإعادة الاستشهاد بنفس `file_id` لا تستدعي رسماً جديداً للتحليل. لكن محتوى الملف يُحتسب في كل مرة يدخل فيها إلى السياق كرموز إدخال (Input Tokens)، لذا فإن التكلفة الأساسية للأسئلة المتعددة حول الملفات الكبيرة تأتي من رموز الإدخال.

س7: ما القيود المعروفة في واجهات API لحزمة DeepSeek الكاملة؟

– تكامل الأدوات على مستوى المحادثة الكاملة متاح حالياً لـ `deepseek-flash` فقط
– واجهة Search المستقلة محدودة بمستوى الحساب عند 100 QPS، وFetch عند 25 QPS، مع تقييد إضافي من النطاق المستهدف
– ASR: أقصى طول للمقطع الواحد 120 ثانية، وغير متدفق (non-streaming)؛ TTS: الحد الأقصى 10000 حرف محتسب في المرة الواحدة، ولا يدعم تعديل سرعة القراءة حالياً
– تحليل الملفات: الحد الأقصى للملف الواحد 100 MiB و1000 صفحة، وبحد أقصى 20 ملفاً في الطلب الواحد

س8: هل يمكن لـ APIYI استدعاء كل الأدوات المدمجة الجديدة التي أصدرتها DeepSeek؟

أصدرت APIYI حاليًا خدمتي `deepseek-search` و`deepseek-fetch` المستقلتين، ويمكنك تنسيقهما بنفسك داخل Agent وRAG. أما العمل على توافق البحث المدمج في النموذج مع عملاء مثل Harness وClaude Code فلا يزال قيد التخطيط، ويُرجى متابعة التقدّم عبر الوثائق الرسمية لـ APIYI على apiyi.com.


أسعار واجهات API لعائلة DeepSeek الكاملة — أهم النقاط

  • هيكل الفوترة: تُحتسب رموز النموذج (Token) واستدعاءات الأدوات بشكل منفصل، لذا تُنتج المهمة الواحدة عدة بنود من الرسوم في الوقت نفسه
  • سعر الوحدة للأدوات: Search وFetch بسعر ¥5 لكل 1000 استدعاء، وتحليل الملفات وOCR بسعر ¥1.5 لكل 1000 صفحة
  • أسعار الصوت: ASR بسعر ¥0.39 / ساعة لفترة محدودة، وTTS بسعر ¥1.5 لكل 10,000 حرف محتسب، ويُحتسب الحرف الصيني كحرفين
  • أكبر بند في الفاتورة: في مهام البحث عبر الإنترنت تشكّل رموز النموذج عادةً أكثر من النصف، وتكون فترات الخمول والتخزين المؤقت هي الأكثر فعالية
  • أثر التخزين المؤقت: عند إصابة 80% من المدخلات في التخزين المؤقت، تنخفض فاتورة السيناريو الأول من ¥57 إلى ¥41.32، أي توفير نحو 27.5%
  • أساس الاحتساب: تُسجّل التكاليف عبر حقل الفوترة server_tool_use، وقد تتضمن حقول العرض طلبات فاشلة
  • كيفية البدء: يمكن استدعاء Search / Fetch المستقلين واختبارهما عبر APIYI على apiyi.com باستخدام مفتاح موحّد

الملخص

النقاط الأساسية في أسعار واجهات API لمجموعة DeepSeek الكاملة:

  1. احسب التكلفة حسب المهمة: تكلفة مهمة Agent واحدة = المدخلات + المخرجات + الأدوات + الملفات والصوت، وسعر الطلب الواحد لا يعكس إلا بندًا واحدًا منها
  2. الرموز (Tokens) تتحكم في الفاتورة: سعر الأدوات للوحدة منخفض، لكن السياق الطويل والملفات المتكررة ومخرجات التفكير هي الأسباب الرئيسية لنمو التكلفة
  3. طريقة القياس تحدد درجة التحكم: البحث المدمج يُحاسب حسب كلمات الاستعلام وهو مناسب للتطوير، بينما الواجهة المستقلة تُحاسب حسب الطلب وتضمن استقرار الميزانية

عند التنفيذ الفعلي، ابدأ بتشغيل دالة التكلفة الواردة في هذا المقال على عينة صغيرة لاستخراج حقول الفوترة الحقيقية، ثم اضربها في حجم العمل للحصول على الميزانية، واترك هامشًا لانتهاء صلاحية الخصومات محدودة المدة. أما الفرق التي تحتاج إلى تنظيم عملية البحث والجلب بنفسها، فيمكنها استدعاء واجهات DeepSeek Search / Fetch المستقلة عبر APIYI apiyi.com، ومقارنة الأسعار بالعملة نفسها بناءً على الأسعار الفعلية في لوحة التحكم.


📚 المراجع

  1. نماذج DeepSeek وأسعارها: الوثيقة الرسمية للأسعار المحدثة لحظيًا
  2. الرابط: api-docs.deepseek.com/zh-cn/quick_start/pricing
  3. الوصف: سعر الرموز للنموذج، وفترات الذروة وأوقات الخمول، وأسعار الأدوات

  4. أدوات DeepSeek للاتصال بالشبكة: الوثيقة التقنية للبحث المدمج وروابط القراءة

  5. الرابط: api-docs.deepseek.com/zh-cn/guides/web_tools
  6. الوصف: تفاصيل فوترة البحث العميق، وحقل الفوترة server_tool_use

  7. بحث DeepSeek على الويب والجلب: وثيقة Search / Fetch المستقلة

  8. الرابط: api-docs.deepseek.com/zh-cn/guides/search
  9. الوصف: تعريف الطلب الناجح، وحدود QPS، ومعالجة رموز الأخطاء

  10. تحليل الملفات / OCR / ASR / TTS في DeepSeek: الوثائق التقنية لكل أداة

  11. الرابط: api-docs.deepseek.com/zh-cn/guides/document_parsing
  12. الوصف: في المجلد نفسه يمكنك الاطلاع على قيود ocr وasr وtts ووحدات الفوترة

  13. إعلان واجهات API لتطبيقات مجموعة DeepSeek الكاملة: صدر في 13 نوفمبر 2026

  14. الرابط: api-docs.deepseek.com/zh-cn/news/news261113
  15. الوصف: قائمة القدرات المفتوحة هذه المرة ونطاق دعم النماذج

المؤلف: فريق APIYI التقني
التواصل التقني: نرحب بتواصلك معنا عبر الصفحة الرئيسية لموقع APIYI، ويمكن الاطلاع على معاملات واجهات DeepSeek Search / Fetch وأحدث الأسعار في مركز وثائق APIYI

مقالات ذات صلة

موضوعات ذات صلة