Endpointy

Wyszukiwanie w sieci

Oprzyj odpowiedzi modelu na aktualnych wynikach z internetu za pomocą wariantu :online, wtyczki web lub web_search_options.

Wypróbuj w playground

Wyszukiwanie w sieci dodaje do kontekstu modelu aktualne wyniki z internetu i zwraca cytowania z adresami URL. Możesz je włączyć dla dowolnego modelu tekstowego na trzy sposoby.

1. Wariant `:online`

Dodaj :online do dowolnego identyfikatora modelu:

{ "model": "openai/gpt-5-mini:online", "messages": [{ "role": "user", "content": "What happened in AI this week?" }] }

:online stosuje te same ceny, listę dozwolonych modeli klucza i zasady planu co model bazowy. Zobacz Identyfikatory modeli.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api14.com/api/v1",
  apiKey: process.env.API14_API_KEY,
});

const result = await client.chat.completions.create({
  "model": "openai/gpt-5-mini:online",
  "messages": [
    {
      "role": "user",
      "content": "What are the latest AI model releases this week?"
    }
  ]
});
console.log(result.choices[0].message.content);

2. Wtyczka `web`

Wtyczka daje kontrolę nad wyszukiwaniem:

{
  "model": "anthropic/claude-sonnet-4.5",
  "messages": [{ "role": "user", "content": "Latest stable Node.js version?" }],
  "plugins": [
    { "id": "web", "max_results": 5, "engine": "exa", "search_prompt": "Use these sources:" }
  ]
}

Pole	Typ	Opis
`plugins[].id`	string	`"web"`
`max_results`	integer	Liczba wstrzykiwanych wyników (domyślnie 5).
`engine`	string	`"native"` (własne wyszukiwanie dostawcy, gdy jest dostępne) lub `"exa"`. Jeśli pominiesz to pole, używane jest wyszukiwanie natywne, gdy jest dostępne, a w przeciwnym razie Exa.
`search_prompt`	string	Tekst umieszczany przed wstrzykniętymi wynikami.

3. `web_search_options`

Opcja w stylu OpenAI dla modeli z natywnym wyszukiwaniem:

{
  "model": "openai/gpt-4o-search-preview",
  "messages": [{ "role": "user", "content": "Who won yesterday's match?" }],
  "web_search_options": { "search_context_size": "high" }
}

search_context_size przyjmuje wartości "low", "medium" lub "high". Określa, ile treści z wyszukiwania jest pobieranych, oraz wpływa na cenę.

Odpowiedź

Cytowania są zwracane jako annotations w wiadomości:

{
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "The latest LTS release is ... [nodejs.org](https://nodejs.org/en/blog)",
        "annotations": [
          {
            "type": "url_citation",
            "url_citation": { "url": "https://nodejs.org/en/blog", "title": "Node.js Blog", "start_index": 25, "end_index": 60, "content": "..." }
          }
        ]
      }
    }
  ],
  "usage": { "prompt_tokens": 2410, "completion_tokens": 85, "total_tokens": 2495, "cost": 0.02061 }
}

Cennik

Oprócz tokenów wyszukiwanie ma własną cenę: Exa jest rozliczane za wynik, a wyszukiwanie natywne za zapytanie według ceny web_search modelu. Wyniki wyszukiwania liczą się również jako tokeny wejściowe. Całość jest uwzględniona w usage.cost i pobierana w USD. Zobacz Ceny i rozliczenia.

Błędy

Takie same jak w Chat completions. Zobacz Błędy.