# חיפוש אינטרנט מבוסס מודל (OpenAI).

**API:** Data API

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

**Tags:** OpenAI Web Search

יצירת תשובה עם ציטוטים באמצעות מודל OpenAI וחיפוש באינטרנט. ספקו input כמחרוזת או כמערך הודעות. המודל, הכלים ומגבלת החיפוש מנוהלים על ידי השירות. התגובה היא אובייקט Responses שה-output שלו כולל פריטי web_search_call והודעות עם ציטוטי URL. usage מדווח על צריכת משאבים, לא על חיוב Felo.

### מראה תמחור

- מדידה: רכיבי תגובה נמדדים.
- אומדן בקשת ייחוס: 0.3 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של 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": "השאלה או ההוראה שלכם, באותו פורמט כמו `input` של OpenAI Responses API. מתקבל גם מערך הודעות.",
      "example": "What are the three biggest AI announcements this week? Give one sentence each with sources."
    },
    "max_output_tokens": {
      "type": "integer",
      "description": "מגבלה אופציונלית על מספר הטוקנים שנוצרים בתשובה.",
      "example": 1024
    },
    "instructions": {
      "type": "string",
      "description": "הוראות כלליות אופציונליות לכוון את הטון או הפורמט של התשובה."
    }
  }
}
```

Example:

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

## Responses

### 200 — אובייקט OpenAI Responses סטנדרטי. `output[]` משזור פריטי web_search_call ואת הודעת התשובה עם הציטוטים; מספר פריטי web_search_call הוא מספר החיפושים המחויב.

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת 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": "פריטים מסודרים: web_search_call (חיפושים שבוצעו) ו-message (התשובה המצוטטת).",
      "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 — לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

### 401 — נדרש מפתח API תקף של Felo.

### 402 — לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

### 403 — החשבון אינו מורשה לבצע את הפעולה הזו.

### 429 — הגעתם למגבלת בקשות או לתקרת הוצאה.

### 502 — השירות לא הצליח להשלים את הבקשה.

### 503 — שירות ה-API או החיוב אינו זמין באופן זמני.

### 504 — השירות פג בזמן הטיפול בבקשה.

### default — תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

**application/json**

Schema:

```json
{}
```
