Aller au contenu
Référence API
Référence API

DeepSeek Search

Envoyez une requête via l’opération Search compatible DeepSeek de RunAPI.

Voir en Markdown
01

Vue d'ensemble

Recherche synchrone sélectionnée par ce chemin. Aucun modèle requis ; le streaming n’est pas pris en charge. Les champs inconnus sont acceptés mais ignorés.

Démarrage rapide

  1. Créez une clé API et définissez-la comme RUNAPI_API_KEY.
  2. Envoyez le corps JSON documenté ; aucun modèle n’est requis.
  3. Lisez la réponse JSON et gérez les erreurs de protocole documentées.

Point de terminaison

POST /v1/tools/search
URL de base
https://runapi.ai
Version du contrat
v1
Authentification recommandée
Authorization: Bearer YOUR_API_TOKEN
02

Supports d'authentification

RunAPI accepte chaque protocole listé ci-dessous. Les exemples générés utilisent l'en-tête préféré du protocole.

header - Recommandé
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

Modèles compatibles

Ouvrez une page de modèle pour consulter la tarification actuelle, les limites de débit et les conditions d'utilisation commerciale.

Afficher 1 modèle compatible
04

Contrat de requête

Corps JSON

Recherche synchrone sélectionnée par ce chemin. Aucun modèle requis ; le streaming n’est pas pris en charge. Les champs inconnus sont acceptés mais ignorés.

Corps JSON5 champs
countinteger
Optionnel

Nombre de résultats demandés, de 1 à 50.

localizationstring
Optionnel

Indication de localisation, telle que l’adresse IP de l’utilisateur final.

need_contentboolean
Optionnel

Demander le contenu des pages dans les résultats de recherche.

ori_question["string", "null"]
Optionnel

Question initiale de 1–128 caractères Unicode. Null est traité comme une omission.

querystring
Requis

Requête de 1–128 caractères Unicode ; ne doit pas contenir uniquement des espaces.

Exemple de requête

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

Réponse synchrone

HTTP 200

Schéma

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "Résultats de recherche. Un tableau vide est une réponse réussie et ne génère aucun frais.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

Exemple

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

Erreur de protocole : invalid_request

HTTP 400

Schéma

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

Exemple

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

Erreur de protocole : rate_limited

HTTP 429

Schéma

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

Exemple

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

Erreur de protocole : unavailable

HTTP 503

Schéma

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

Exemple

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

Exemples de code générés

Chaque exemple cURL, JavaScript et Python envoie la requête validée depuis ce contrat sans nécessiter de SDK spécifique au protocole.

Installer

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