Endpoints

Webzoeken

Onderbouw antwoorden met actuele webresultaten via de variant :online, de web-plugin of web_search_options, met bronvermelding en prijzen.

Probeer het in de playground

Webzoeken voegt actuele webresultaten toe aan de context van het model en geeft URL-bronvermeldingen terug. Je kunt het op drie manieren inschakelen voor elk tekstmodel.

1. De variant `:online`

Voeg :online toe aan elk model-id:

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

:online gebruikt dezelfde prijzen, key-allowlist en abonnementsregels als het basismodel. Zie Model-id's.

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. De plugin `web`

De plugin geeft je controle over de zoekopdracht:

{
  "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:" }
  ]
}

Veld	Type	Beschrijving
`plugins[].id`	string	`"web"`
`max_results`	integer	Aantal resultaten dat wordt ingevoegd (standaard 5).
`engine`	string	`"native"` (de eigen zoekfunctie van de provider, indien beschikbaar) of `"exa"`. Laat je het weg, dan wordt native gebruikt wanneer beschikbaar, anders Exa.
`search_prompt`	string	Tekst die vóór de ingevoegde resultaten wordt geplaatst.

3. `web_search_options`

De optie in OpenAI-stijl voor modellen met native zoeken:

{
  "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 is "low", "medium" of "high". Het bepaalt hoeveel zoekinhoud wordt opgehaald, en de prijs.

Response

Bronvermeldingen komen terug als annotations op het bericht:

{
  "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 }
}

Prijzen

Bovenop tokens heeft zoeken een eigen prijs: Exa wordt per resultaat gefactureerd, en native zoeken per request volgens de prijs web_search van het model. De zoekresultaten tellen ook als invoertokens. Alles is opgenomen in usage.cost en wordt in USD afgeschreven. Zie Prijzen en facturering.

Fouten

Hetzelfde als bij Chat completions. Zie Fouten.