# Spiega i risultati di ricerca

**API:** Data API

**Endpoint:** `POST /v1/beta/scholar/search/explain`

**Tags:** Scholar Search

Spiega i risultati di ricerca recuperati in precedenza. Fornisci lo search_id restituito da una ricerca Scholar, con detail_level e language facoltativi. response_mode=NON_STREAMING restituisce JSON con message; COMPLETE e INCREMENTAL restituiscono text/event-stream, dove ogni evento contiene la spiegazione accumulata. Questa operazione spiega una ricerca esistente e non ne avvia un'altra.

### Riferimento prezzi

- Misurazione: base di costo fissa per richiesta riuscita.
- Stima di riferimento per richiesta: USD 0.01.
- Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "required": [
    "search_id"
  ],
  "properties": {
    "search_id": {
      "type": "string",
      "description": "ID della ricerca da spiegare"
    },
    "response_mode": {
      "type": "string",
      "enum": [
        "COMPLETE",
        "INCREMENTAL",
        "NON_STREAMING"
      ],
      "default": "NON_STREAMING",
      "description": "Formato della risposta di spiegazione. COMPLETE e INCREMENTAL trasmettono server-sent events; NON_STREAMING restituisce una risposta JSON."
    },
    "language": {
      "type": "string",
      "default": "en",
      "description": "Codice lingua per la spiegazione (ad es. en, zh, ar)",
      "example": "ar"
    },
    "detail_level": {
      "type": "string",
      "enum": [
        "BRIEF",
        "MODERATE",
        "DETAILED"
      ],
      "default": "MODERATE",
      "description": "Livello di dettaglio della spiegazione"
    }
  }
}
```

## Responses

### 200 — Risposta di spiegazione riuscita. COMPLETE/INCREMENTAL trasmettono text/event-stream; NON_STREAMING restituisce application/json.

Headers:
- `X-Request-Id` (string) — Identificatore della richiesta da includere quando contatti l'assistenza Felo.

**application/json**

Schema: `Response8Da310D1D213_ExplainSearchResponse` (`#/components/schemas/Response8Da310D1D213_ExplainSearchResponse`)

**text/event-stream**

Schema: string

```json
{
  "type": "string"
}
```

### 400 — Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

### 401 — È richiesta una chiave API Felo valida.

### 402 — Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

### 403 — L'account non è autorizzato a eseguire questa operazione.

### 429 — È stato raggiunto un limite di richieste o di spesa.

### 502 — Il servizio non è riuscito a completare la richiesta.

### 503 — L'API o il servizio di fatturazione è temporaneamente non disponibile.

### 504 — Si è verificato un timeout durante l'elaborazione della richiesta.

### default — Risposta di errore; le risposte passthrough upstream possono usare formati del provider

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response8Da310D1D213_ExplainSearchResponse

`#/components/schemas/Response8Da310D1D213_ExplainSearchResponse`

```json
{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "description": "Testo della spiegazione generato."
    }
  },
  "description": "Risposta di spiegazione JSON restituita quando response_mode è NON_STREAMING."
}
```
