Saltar al contenido
Referencia de API
Referencia de API

DeepSeek Search

Envía una solicitud mediante la operación Search compatible con DeepSeek de RunAPI.

Ver Markdown
01

Descripción general

Búsqueda síncrona seleccionada por esta ruta. No requiere modelo ni admite streaming. Los campos desconocidos se aceptan, pero se ignoran.

Inicio rápido

  1. Cree una Clave de API y establézcala como RUNAPI_API_KEY.
  2. Envía el cuerpo JSON documentado; no se requiere modelo.
  3. Lee la respuesta JSON y gestiona los errores de protocolo documentados.

Endpoint

POST /v1/tools/search
URL base
https://runapi.ai
Versión del contrato
v1
Autenticación preferida
Authorization: Bearer YOUR_API_TOKEN
02

Portadores de autenticación

RunAPI acepta cada uno de los carriers indicados a continuación. Los ejemplos generados utilizan el encabezado preferido del protocolo.

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

Modelos compatibles

Abra una página de modelo para conocer los precios actuales, los límites de velocidad y los detalles de uso comercial.

Mostrar 1 modelo compatible
04

Contrato de solicitud

Cuerpo JSON

Búsqueda síncrona seleccionada por esta ruta. No requiere modelo ni admite streaming. Los campos desconocidos se aceptan, pero se ignoran.

Cuerpo JSON5 campos
countinteger
Opcional

Número de resultados solicitados de 1 a 50.

localizationstring
Opcional

Indicación de localización, como la dirección IP del usuario final.

need_contentboolean
Opcional

Solicitar contenido de las páginas en los resultados de búsqueda.

ori_question["string", "null"]
Opcional

Pregunta original de 1–128 caracteres Unicode. Null se considera omitido.

querystring
Obligatorio

Consulta de 1–128 caracteres Unicode; no puede contener solo espacios en blanco.

Ejemplo de solicitud

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

Respuesta síncrona

HTTP 200

Esquema

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "Resultados de búsqueda. Un array vacío es una respuesta correcta y no genera cargos.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

Ejemplo

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

Error de protocolo: invalid_request

HTTP 400

Esquema

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

Ejemplo

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

Error de protocolo: rate_limited

HTTP 429

Esquema

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

Ejemplo

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

Error de protocolo: unavailable

HTTP 503

Esquema

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

Ejemplo

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

Ejemplos de código generados

Cada muestra de cURL, JavaScript y Python envía la solicitud validada de este contrato sin requerir un SDK específico del protocolo.

Instalar

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