Endpoint

Web search

Dasari jawaban dengan hasil web langsung memakai varian :online, plugin web, atau web_search_options, lengkap dengan sitasi URL dan harga.

Coba di playground

Web search menambahkan hasil web langsung ke konteks model dan mengembalikan sitasi URL. Anda dapat mengaktifkannya untuk model teks apa pun dengan tiga cara.

1. Varian `:online`

Tambahkan :online ke ID model apa pun:

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

:online memakai harga, allowlist key, dan aturan paket yang sama dengan model dasarnya. Lihat ID model.

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. Plugin `web`

Plugin ini memberi Anda kendali atas pencarian:

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

Field	Tipe	Deskripsi
`plugins[].id`	string	`"web"`
`max_results`	integer	Jumlah hasil yang disisipkan (default 5).
`engine`	string	`"native"` (pencarian milik provider sendiri, jika tersedia) atau `"exa"`. Jika dihilangkan, native dipakai bila tersedia, jika tidak Exa.
`search_prompt`	string	Teks yang ditempatkan sebelum hasil yang disisipkan.

3. `web_search_options`

Opsi gaya OpenAI untuk model dengan pencarian native:

{
  "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 adalah "low", "medium", atau "high". Nilai ini menentukan seberapa banyak konten pencarian yang diambil, dan harganya.

Respons

Sitasi dikembalikan sebagai annotations pada pesan:

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

Harga

Selain token, pencarian memiliki harga sendiri: Exa ditagih per hasil, dan pencarian native per request sesuai harga web_search model. Hasil pencarian juga dihitung sebagai token input. Semuanya termasuk dalam usage.cost dan dipotong dalam USD. Lihat Harga dan penagihan.

Error

Sama seperti Chat completions. Lihat Error.