Uç noktalar

Web araması

Herhangi bir metin modeline :online varyantı, web eklentisi veya web_search_options ile canlı web sonuçları ekleyin ve URL atıflarını alın.

Playground’da dene

Web araması, modelin bağlamına canlı web sonuçları ekler ve URL atıfları döndürür. Herhangi bir metin modelinde üç şekilde açabilirsiniz.

1. `:online` varyantı

Herhangi bir model kimliğinin sonuna :online ekleyin:

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

:online, temel modelle aynı fiyatlandırmayı, anahtar izin listesini ve plan kurallarını kullanır. Bkz. Model kimlikleri.

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

Eklenti, arama üzerinde kontrol sağlar:

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

Alan	Tür	Açıklama
`plugins[].id`	string	`"web"`
`max_results`	integer	Eklenecek sonuç sayısı (varsayılan 5).
`engine`	string	`"native"` (varsa sağlayıcının kendi araması) veya `"exa"`. Belirtmezseniz, varsa native, yoksa Exa kullanılır.
`search_prompt`	string	Eklenen sonuçlardan önce yerleştirilen metin.

3. `web_search_options`

Yerel aramalı modeller için OpenAI tarzı seçenek:

{
  "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 değeri "low", "medium" veya "high" olur. Ne kadar arama içeriği getirileceğini ve fiyatı belirler.

Yanıt

Atıflar, mesajda annotations olarak döner:

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

Fiyatlandırma

Token'lara ek olarak aramanın kendi fiyatı vardır: Exa sonuç başına, native arama ise modelin web_search fiyatına göre istek başına ücretlendirilir. Arama sonuçları da girdi token'ı sayılır. Hepsi usage.cost içine dahildir ve USD olarak düşülür. Bkz. Fiyatlandırma ve faturalandırma.

Hatalar

Chat completions ile aynıdır. Bkz. Hatalar.