Naar inhoud springen
API-referentie
API-referentie

DeepSeek Search

Stuur een verzoek via de DeepSeek-compatibele Search-operatie van RunAPI.

Markdown bekijken
01

Overzicht

Synchroon zoeken via dit pad. Er is geen model vereist en streaming wordt niet ondersteund. Onbekende velden worden geaccepteerd maar genegeerd.

Snelstart

  1. Maak een API-sleutel aan en stel deze in als RUNAPI_API_KEY.
  2. Stuur de gedocumenteerde JSON-body; er is geen model vereist.
  3. Lees het JSON-antwoord en handel de gedocumenteerde protocolfouten af.

Eindpunt

POST /v1/tools/search
Basis-URL
https://runapi.ai
Contractversie
v1
Voorkeursauthenticatie
Authorization: Bearer YOUR_API_TOKEN
02

Authenticatiedragers

RunAPI accepteert elke hieronder vermelde carrier. Gegenereerde voorbeelden gebruiken de voorkeurskoptekst van het protocol.

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

Compatibele modellen

Open een modelpagina voor actuele prijzen, snelheidslimieten en details over commercieel gebruik.

Toon 1 compatibel model
04

Verzoekcontract

JSON-body

Synchroon zoeken via dit pad. Er is geen model vereist en streaming wordt niet ondersteund. Onbekende velden worden geaccepteerd maar genegeerd.

JSON-body5 velden
countinteger
Optioneel

Aantal gevraagde resultaten van 1 tot 50.

localizationstring
Optioneel

Locatiehint, zoals het IP-adres van de eindgebruiker.

need_contentboolean
Optioneel

Vraag pagina-inhoud op in zoekresultaten.

ori_question["string", "null"]
Optioneel

Oorspronkelijke vraag van 1–128 Unicode-tekens. Null wordt behandeld als weggelaten.

querystring
Verplicht

Zoekopdracht van 1–128 Unicode-tekens; mag niet uitsluitend uit witruimte bestaan.

Verzoekvoorbeeld

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

Synchroon antwoord

HTTP 200

Schema

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "Zoekresultaten. Een lege array is een geslaagd antwoord en brengt geen kosten met zich mee.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

Voorbeeld

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

Protocolfout: invalid_request

HTTP 400

Schema

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

Voorbeeld

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

Protocolfout: rate_limited

HTTP 429

Schema

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

Voorbeeld

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

Protocolfout: unavailable

HTTP 503

Schema

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

Voorbeeld

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

Gegenereerde codevoorbeelden

Elk cURL-, JavaScript- en Python-voorbeeld verstuurt de gevalideerde aanvraag uit dit contract zonder dat een protocolspecifieke SDK vereist is.

Installeren

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