# Recherche web ancrée sur un modèle (OpenAI).

**API:** Data API

**Endpoint:** `POST /v1/beta/openai-websearch/search`

**Tags:** OpenAI Web Search

Génère une réponse sourcée avec un modèle OpenAI et la recherche web. Fournissez input sous forme de chaîne ou de tableau de messages. Le modèle, les outils et la limite de recherche sont gérés par le service. La réponse est un objet Responses dont output contient des éléments web_search_call et message avec des citations d'URL. usage indique une consommation de ressources, pas un débit Felo.

### Référence tarifaire

- Mesure : composants de réponse mesurés.
- Estimation de référence par requête : USD 0.3.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation 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": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Votre question ou instruction, au même format que le champ `input` de l'API Responses d'OpenAI. Un tableau de messages est également accepté.",
      "example": "What are the three biggest AI announcements this week? Give one sentence each with sources."
    },
    "max_output_tokens": {
      "type": "integer",
      "description": "Plafond facultatif du nombre de tokens générés dans la réponse.",
      "example": 1024
    },
    "instructions": {
      "type": "string",
      "description": "Instructions de haut niveau facultatives pour orienter le ton ou le format de la réponse."
    }
  }
}
```

Example:

```json
{
  "input": "What are the three biggest AI announcements this week? Give one sentence each with sources.",
  "max_output_tokens": 1024
}
```

## Responses

### 200 — Un objet Responses standard d'OpenAI. `output[]` entrelace des éléments web_search_call et le message de réponse sourcé ; le nombre d'éléments web_search_call correspond au nombre de recherches facturées.

Headers:
- `X-Request-Id` (string) — Identifiant de requête à inclure lorsque vous contactez le support Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "object": {
      "type": "string",
      "example": "response"
    },
    "status": {
      "type": "string",
      "example": "completed"
    },
    "output": {
      "type": "array",
      "description": "Éléments ordonnés : web_search_call (recherches effectuées) et message (la réponse citée).",
      "items": {
        "type": "object"
      }
    },
    "usage": {
      "type": "object",
      "properties": {
        "input_tokens": {
          "type": "integer"
        },
        "output_tokens": {
          "type": "integer"
        },
        "input_tokens_details": {
          "type": "object",
          "properties": {
            "cached_tokens": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}
```

### 400 — La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

### 401 — Une clé API Felo valide est requise.

### 402 — La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

### 403 — Le compte n'est pas autorisé à effectuer cette opération.

### 429 — Une limite de requêtes ou de dépenses a été atteinte.

### 502 — Le service n'a pas pu terminer la requête.

### 503 — L'API ou le service de facturation est temporairement indisponible.

### 504 — Le service a expiré lors du traitement de la requête.

### default — Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

**application/json**

Schema:

```json
{}
```
