تخطَّ إلى المحتوى
مرجع API
مرجع API

DeepSeek Search

أرسل طلبًا عبر عملية Search المتوافقة مع DeepSeek في RunAPI.

عرض Markdown
01

نظرة عامة

بحث متزامن يحدده هذا المسار. لا يتطلب نموذجًا ولا يدعم البث. تُقبل الحقول غير المعروفة ولكن يتم تجاهلها.

البدء السريع

  1. أنشئ مفتاح API واضبطه كـ RUNAPI_API_KEY.
  2. أرسل جسم JSON الموثق؛ لا يلزم تحديد نموذج.
  3. اقرأ استجابة JSON وتعامل مع أخطاء البروتوكول الموثقة.

نقطة النهاية

POST /v1/tools/search
عنوان URL الأساسي
https://runapi.ai
إصدار العقد
v1
المصادقة المفضّلة
Authorization: Bearer YOUR_API_TOKEN
02

وسائل حمل المصادقة

يقبل RunAPI كل بروتوكول مُدرج أدناه. تستخدم العينات المُولَّدة الترويسة المفضَّلة للبروتوكول.

header - مفضّل
Authorization: Bearer YOUR_API_TOKEN
header
x-api-key: YOUR_API_TOKEN
header
x-goog-api-key: YOUR_API_TOKEN
query
?key=YOUR_API_TOKEN
03

النماذج المتوافقة

افتح صفحة النموذج للاطلاع على التسعير الحالي وحدود المعدل وتفاصيل الاستخدام التجاري.

عرض 1 نموذج متوافق
04

عقد الطلب

نص JSON

بحث متزامن يحدده هذا المسار. لا يتطلب نموذجًا ولا يدعم البث. تُقبل الحقول غير المعروفة ولكن يتم تجاهلها.

جسم JSON5 حقل
countinteger
اختياري

عدد النتائج المطلوبة من 1 إلى 50.

localizationstring
اختياري

تلميح للموقع مثل عنوان IP للمستخدم النهائي.

need_contentboolean
اختياري

طلب محتوى الصفحات ضمن نتائج البحث.

ori_question["string", "null"]
اختياري

السؤال الأصلي من 1–128 حرف Unicode. تُعامل Null كقيمة محذوفة.

querystring
مطلوب

استعلام بحث من 1–128 حرف Unicode؛ يجب ألا يتكون بالكامل من مسافات بيضاء.

مثال على الطلب

JSON 
{
  "count": 5,
  "localization": "203.0.113.7",
  "need_content": true,
  "ori_question": null,
  "query": "DeepSeek V4 release"
}
05

استجابة متزامنة

HTTP 200

المخطط

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "نتائج البحث. المصفوفة الفارغة استجابة ناجحة ولا تُحتسب عليها رسوم.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

مثال

JSON 
{
  "results": [
    {
      "snippet": "Browse DeepSeek models and API documentation.",
      "title": "DeepSeek models on RunAPI",
      "url": "https://runapi.ai/models/deepseek"
    }
  ]
}
06

خطأ في البروتوكول: invalid_request

HTTP 400

المخطط

JSON 
{
  "additionalProperties": true,
  "properties": {
    "error": {
      "additionalProperties": true,
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ]
        },
        "message": {
          "type": "string"
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}

مثال

JSON 
{
  "error": {
    "message": "'query' is required",
    "type": "invalid_request_error"
  }
}
07

خطأ في البروتوكول: rate_limited

HTTP 429

المخطط

JSON 
{
  "additionalProperties": true,
  "properties": {
    "error": {
      "additionalProperties": true,
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ]
        },
        "message": {
          "type": "string"
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}

مثال

JSON 
{
  "error": {
    "message": "Too many requests, please retry later",
    "type": "rate_limit_error"
  }
}
08

خطأ في البروتوكول: unavailable

HTTP 503

المخطط

JSON 
{
  "additionalProperties": true,
  "properties": {
    "error": {
      "additionalProperties": true,
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ]
        },
        "message": {
          "type": "string"
        },
        "param": {
          "type": [
            "string",
            "null"
          ]
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "message",
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "error"
  ],
  "type": "object"
}

مثال

JSON 
{
  "error": {
    "message": "Service temporarily unavailable",
    "type": "service_unavailable"
  }
}
09

نماذج الأكواد المولَّدة

كل نموذج من نماذج cURL وJavaScript وPython يُرسل الطلب المُتحقق منه من هذا العقد دون الحاجة إلى SDK خاص بالبروتوكول.

التثبيت

Shell 
pip install requests
PYTHON 
import requests

response = requests.post(
    "https://runapi.ai/v1/tools/search",
    headers={"Authorization": "Bearer YOUR_API_TOKEN", "Content-Type": "application/json"},
    json={"query": "DeepSeek V4 release", "count": 5, "ori_question": None, "localization": "203.0.113.7", "need_content": True}
)
response.raise_for_status()
print(response.json())