Przejdź do treści
Dokumentacja API
Dokumentacja API

DeepSeek Search

Wyślij żądanie za pomocą operacji Search zgodnej z DeepSeek w RunAPI.

Zobacz Markdown
01

Omówienie

Wyszukiwanie synchroniczne wybrane przez tę ścieżkę. Model nie jest wymagany, a strumieniowanie nie jest obsługiwane. Nieznane pola są akceptowane, ale ignorowane.

Szybki start

  1. Utwórz klucz API i ustaw go jako RUNAPI_API_KEY.
  2. Wyślij udokumentowaną treść JSON; model nie jest wymagany.
  3. Odczytaj odpowiedź JSON i obsłuż udokumentowane błędy protokołu.

Punkt końcowy

POST /v1/tools/search
Bazowy URL
https://runapi.ai
Wersja kontraktu
v1
Preferowane uwierzytelnianie
Authorization: Bearer YOUR_API_TOKEN
02

Nośniki uwierzytelniania

RunAPI akceptuje każdy z wymienionych poniżej protokołów. Wygenerowane przykłady używają preferowanego nagłówka danego protokołu.

header - Preferowane
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

Zgodne modele

Otwórz stronę modelu, aby zapoznać się z aktualnymi cenami, limitami żądań i szczegółami dotyczącymi użytku komercyjnego.

Pokaż 1 kompatybilny model
04

Kontrakt żądania

Treść JSON

Wyszukiwanie synchroniczne wybrane przez tę ścieżkę. Model nie jest wymagany, a strumieniowanie nie jest obsługiwane. Nieznane pola są akceptowane, ale ignorowane.

Treść JSON5 pola
countinteger
Opcjonalne

Żądana liczba wyników od 1 do 50.

localizationstring
Opcjonalne

Wskazówka lokalizacji, np. adres IP użytkownika końcowego.

need_contentboolean
Opcjonalne

Żądaj treści stron w wynikach wyszukiwania.

ori_question["string", "null"]
Opcjonalne

Oryginalne pytanie o długości 1–128 znaków Unicode. Null jest traktowane jako pominięcie.

querystring
Wymagane

Zapytanie o długości 1–128 znaków Unicode; nie może składać się wyłącznie z białych znaków.

Przykład żądania

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

Odpowiedź synchroniczna

HTTP 200

Schemat

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "Wyniki wyszukiwania. Pusta tablica oznacza udaną odpowiedź i nie powoduje naliczenia opłaty.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

Przykład

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

Błąd protokołu: invalid_request

HTTP 400

Schemat

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"
}

Przykład

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

Błąd protokołu: rate_limited

HTTP 429

Schemat

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"
}

Przykład

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

Błąd protokołu: unavailable

HTTP 503

Schemat

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"
}

Przykład

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

Wygenerowane przykłady kodu

Każdy przykład cURL, JavaScript i Python wysyła zwalidowane żądanie z tej specyfikacji bez konieczności używania SDK właściwego dla protokołu.

Instalacja

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())