Vai al contenuto
Riferimento API
Riferimento API

DeepSeek Search

Invia una richiesta tramite l’operazione Search compatibile con DeepSeek di RunAPI.

Visualizza Markdown
01

Panoramica

Ricerca sincrona selezionata da questo percorso. Non richiede un modello e non supporta lo streaming. I campi sconosciuti sono accettati ma ignorati.

Avvio rapido

  1. Crea una Chiave API e impostala come RUNAPI_API_KEY.
  2. Invia il corpo JSON documentato; non è richiesto un modello.
  3. Leggi la risposta JSON e gestisci gli errori di protocollo documentati.

Endpoint

POST /v1/tools/search
URL di base
https://runapi.ai
Versione del contratto
v1
Autenticazione preferita
Authorization: Bearer YOUR_API_TOKEN
02

Vettori di autenticazione

RunAPI accetta ciascun protocollo elencato di seguito. I campioni generati utilizzano l'header preferito del protocollo.

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

Modelli compatibili

Apri la pagina di un modello per i prezzi correnti, i limiti di frequenza e i dettagli sull'uso commerciale.

Mostra 1 modello compatibile
04

Contratto della richiesta

Corpo JSON

Ricerca sincrona selezionata da questo percorso. Non richiede un modello e non supporta lo streaming. I campi sconosciuti sono accettati ma ignorati.

Corpo JSON5 campi
countinteger
Opzionale

Numero di risultati richiesti da 1 a 50.

localizationstring
Opzionale

Indicazione della localizzazione, ad esempio l’indirizzo IP dell’utente finale.

need_contentboolean
Opzionale

Richiedi il contenuto delle pagine nei risultati di ricerca.

ori_question["string", "null"]
Opzionale

Domanda originale di 1–128 caratteri Unicode. Null viene considerato omesso.

querystring
Obbligatorio

Query di ricerca di 1–128 caratteri Unicode; non può contenere solo spazi.

Esempio di richiesta

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

Risposta sincrona

HTTP 200

Schema

JSON 
{
  "additionalProperties": true,
  "properties": {
    "results": {
      "description": "Risultati di ricerca. Un array vuoto è una risposta riuscita e non comporta addebiti.",
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}

Esempio

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

Errore di protocollo: 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"
}

Esempio

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

Errore di protocollo: 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"
}

Esempio

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

Errore di protocollo: 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"
}

Esempio

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

Esempi di Codice Generati

Ogni esempio cURL, JavaScript e Python invia la richiesta validata di questo contratto senza richiedere un SDK specifico per il protocollo.

Installa

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