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

**API:** Data API

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

**Tags:** Anthropic Web Search

יצירת תשובה עם ציטוטים באמצעות Claude וחיפוש באינטרנט. ספקו messages ו-max_tokens. המודל וכלי web_search מנוהלים על ידי השירות; max_uses מגביל את מספר החיפושים. התגובה היא אובייקט Anthropic Messages עם בלוקי tool-use, search-result ו-text. 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": [
    "messages",
    "max_tokens"
  ],
  "properties": {
    "messages": {
      "type": "array",
      "description": "הודעות השיחה, באותו פורמט כמו Anthropic Messages API. תור המשתמש מכיל את השאלה שלכם.",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "enum": [
              "user",
              "assistant"
            ]
          },
          "content": {
            "type": "string",
            "description": "טקסט ההודעה. מתקבלים גם בלוקי תוכן מובנים."
          }
        }
      },
      "example": [
        {
          "role": "user",
          "content": "What are the three biggest AI announcements this week? Give one sentence each with sources."
        }
      ]
    },
    "max_tokens": {
      "type": "integer",
      "description": "המספר המרבי של טוקנים ליצירה בתשובה. נדרש על ידי Messages API של ה-upstream.",
      "default": 1024,
      "example": 1024
    },
    "system": {
      "type": "string",
      "description": "הנחיית מערכת אופציונלית לכוון את הטון או הפורמט של התשובה."
    }
  }
}
```

Example:

```json
{
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "What are the three biggest AI announcements this week? Give one sentence each with sources."
    }
  ]
}
```

## Responses

### 200 — תגובת Anthropic Messages סטנדרטית. `content[]` משזור את החיפושים שבוצעו ואת התשובה עם הציטוטים; `usage.server_tool_use.web_search_requests` הוא מספר החיפושים המחויב.

Headers:
- `X-Request-Id` (string) — מזהה בקשה לכלול בעת פנייה לתמיכת Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "example": "message"
    },
    "role": {
      "type": "string",
      "example": "assistant"
    },
    "stop_reason": {
      "type": "string",
      "example": "end_turn"
    },
    "content": {
      "type": "array",
      "description": "בלוקים מסודרים: server_tool_use (שאילתות חיפוש), web_search_tool_result (מקורות) ו-text (התשובה עם הציטוטים).",
      "items": {
        "type": "object"
      }
    },
    "usage": {
      "type": "object",
      "properties": {
        "input_tokens": {
          "type": "integer"
        },
        "output_tokens": {
          "type": "integer"
        },
        "cache_read_input_tokens": {
          "type": "integer"
        },
        "cache_creation_input_tokens": {
          "type": "integer"
        },
        "server_tool_use": {
          "type": "object",
          "properties": {
            "web_search_requests": {
              "type": "integer",
              "description": "מספר חיפושי האינטרנט המחויבים."
            }
          }
        }
      }
    }
  }
}
```

### 400 — לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```
