Yapay zekâ uygulamama web araması nasıl eklenir, arama başına ne kadar öder?
POST https://api.wiozen.com/v1/search ve gövdede query. Aynı API anahtarıyla çalışır ve bakiyenden düşer. Başarılı bir arama 12 Kasım 2026 itibarıyla $0,00009 tutar, yani 1.000 arama $0,09. Arama modelden bağımsız bir istektir: sonucu alır, modele kendi isteminin içinde sen verirsin.Arama isteği nasıl gönderilir?
Gövde bir JSON nesnesi olmalı ve query boş olmayan bir metin olmalı. Aksi halde 400 döner (Missing required parameter: query). Sonuç sayısını max_results ile belirtebilirsin.
curl https://api.wiozen.com/v1/search \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "istanbul hava durumu bu hafta", "max_results": 5}'Yanıt results dizisinde url, title ve snippet alanlarını taşır:
{
"query": "istanbul weather this week",
"results": [
{ "url": "https://...", "title": "...", "snippet": "..." }
]
}Bu alanların içeriği aramayı yapan kaynağa göre değişebilir. İçerik Botu'nu geliştirirken yaptığımız canlı denemede title sorgunun kendisiydi ve url bir yönlendirme bağlantısıydı; gerçek adres bağlantının uddg parametresindeydi. Sonuçtan site adı ya da adres çıkaracaksan aşağıdaki örnekteki gibi önce adresi çöz. Sonuç yalnızca kısa bir özet (snippet) taşır; sayfanın tamamı gelmez. Tam metin gerekiyorsa adresi Markdown çeviren uca ver.
Sonucu modele nasıl veririm?
Arama sohbet isteğinden ayrı bir istektir ve sohbet ucuna otomatik bağlanmaz. Önce aramayı yaparsın, çıkan özetleri soruyla birlikte modele istem olarak verirsin. Örnek (model wiozen-coder):
import requests
from urllib.parse import urlparse, parse_qs
H = {"Authorization": "Bearer sk-gw-..."}
BASE = "https://api.wiozen.com/v1"
def real_url(u):
return parse_qs(urlparse(u).query).get("uddg", [u])[0]
question = "İstanbul'da bu hafta hava nasıl olacak?"
found = requests.post(f"{BASE}/search", json={"query": question, "max_results": 5},
headers=H, timeout=60).json()
notes = "\n".join(f"- {real_url(r.get('url', ''))}: {r.get('snippet', '')}"
for r in found.get("results", []))
r = requests.post(f"{BASE}/chat/completions", headers=H, timeout=600, json={
"model": "wiozen-coder",
"max_tokens": 2000,
"messages": [{"role": "user",
"content": f"Soru: {question}\n\nArama sonuçları:\n{notes}\n\nYalnızca bu sonuçlara dayanarak cevapla ve kullandığın adresleri yaz."}],
})
print(r.json()["choices"][0]["message"]["content"])Aramayı ne zaman yapacağına modelin karar vermesini istiyorsan aramayı bir araç olarak tanımlarsın: model araç çağrısı ister, senin kodun /v1/search ucunu çağırır, sonucu geri verir. Bu döngü araç çağırma rehberinde anlatılıyor.
Arama başına maliyet nedir?
Kodda her başarılı arama sabit 1.000 token sayılır: 500 girdi, 500 çıktı. Bu uç için Modeller sayfasında ayrı bir satır yok; varsayılan fiyat uygulanır, 1 milyon token için girdi $0,03 ve çıktı $0,15. Hesap: 500 × $0,03 / 1M + 500 × $0,15 / 1M = $0,000015 + $0,000075 = $0,00009.
Bunu canlı kayıtla da doğruladık. 13 Ekim ile 11 Kasım 2026 arasında tamamlanan 2.168 aramanın her biri tam $0,00009 tuttu; toplam $0,19512. Ölçümü 12 Kasım 2026'da aldık ve fiyat ileride değişebilir.
Bir soruya arama yapıp cevap yazdıran bir uygulama için örnek hesap. Rakamlar varsayımdır, ölçülmüş bir ortalama değil: 5 sonuçlu istem yaklaşık 3.000 girdi token'ı, cevap 500 çıktı token'ı olsun.
| Kalem | Token | Tutar |
|---|---|---|
| Arama | 1.000 (sabit) | $0,00009 |
| Cevap girdisi, wiozen-coder | 3.000 | $0,00015 |
| Cevap çıktısı, wiozen-coder | 500 | $0,00010 |
| Toplam | $0,00034 |
Yani bu örnekte 1.000 soru yaklaşık $0,34. Cevabın tutarı seçtiğin modele göre değişir, arama kalemi aynı kalır. Model fiyatları Modeller sayfasında, hesap yöntemi maliyet rehberinde.
Hata alırsam ne olur?
Arama sonuç döndüremezse (aramanın kendisi hata verirse) istek ücretlenmez. Boş ya da eksik query ile gelen 400 de ücretsizdir.
Bakiye bittiyse ya da anahtarın harcama limiti dolduysa 429, anahtar yanlışsa 401 gelir (429 rehberi, 401 rehberi). Her aramanın tutarını Kullanım sayfasında istek istek görürsün; ayrıntılı izleme harcama izleme rehberinde. En az bakiye yükleme $5. Kartla yükleme şu an yalnız Türkiye'den, Türkiye'de çıkarılmış bir kartla çalışıyor.
Sık sorulan sorular
Wiozen API'de web araması hangi uçla yapılır?
POST https://api.wiozen.com/v1/search ucuyla. Gövdede query gerekir, max_results isteğe bağlıdır.Arama başına ne kadar ödenir?
Başarısız bir aramadan ücret alınır mı?
Arama sonucu sayfanın tamamını getirir mi?
snippet) ve adres getirir. Sayfanın metni için /v1/web/fetch ucu kullanılır.Model aramayı kendisi yapabilir mi?
Anahtarını Anahtarlar sayfasından alırsın; uçların tam listesi dokümanda.
Hesabını açDiğer rehberler: Türkiye'den kredi kartı olmadan yapay zekâ API'si nasıl kullanılır? · OpenAI uyumlu bir API mevcut bir araca nasıl bağlanır? · Yapay zekâ API maliyeti nasıl hesaplanır? · Yapay zekâ API anahtarım sızdıysa ne yapmalıyım? · Yapay zekâ API'siyle görsel nasıl üretilir ve görsel başı maliyeti ne kadar? · Ses dosyasını yazıya çeviren API'nin dakikası kaç dolar, ücret nasıl hesaplanıyor? · Yapay zekâ API'si neden 429 hatası veriyor, nasıl düzeltilir? · Uzun yanıt bekleyen API isteği neden zaman aşımına düşer: akışlı mı, akışsız mı? · Anthropic Messages API mı, OpenAI Chat Completions mı: hangisini kullanmalıyım? · Bağlam penceresi (context window) nedir, 1 milyon token ne işe yarar? · Hangi yapay zekâ modelini seçmeliyim: fiyat, bağlam ve kaliteye göre karar · Düşünen (reasoning) model neden boş cevap döner, düşünme tokenları neden ücretlenir? · API bakiyem neden beklediğimden hızlı bitiyor? Harcamayı istek istek takip etmek · Bir web sayfası yapay zekâya vermek için Markdown'a nasıl çevrilir? · WordPress'te yapay zekâyla otomatik makale nasıl yazdırılır? · Blog için RSS ve Google Trends'ten konu nasıl bulunur? · Yapay zekâyla yazılan içerik Google'da ve yapay zekâ yanıtlarında görünür mü? · WordPress'te yapay zekâyla yazılan makalelere iç bağlantı nasıl ekletilir? · WordPress'te her yazıya birbirine benzemeyen öne çıkan görsel yapay zekâyla nasıl ürettirilir? · Yapay zekâya blog yazısı yazdırırken içerik tarifi (brief) nasıl yazılır? · Yemek tarifi sitesine yapay zekâyla tarif yazdırırken nelere dikkat etmeli? · WordPress eklentisini yapay zekâ API hesabına bağlarken çıkan hatalar nasıl çözülür? · WordPress'te yapay zekâ yazı botu neden yarıda kalıyor? "Tur takıldı" uyarısı ve LiteSpeed · WordPress'te otomatik yazılar neden geç çıkıyor? WP-Cron ve gerçek sunucu cron'u · Yapay zekâ yazı botuyla İngilizce ya da başka dilde blog yazısı nasıl yazdırılır? · "İçerik Botu yazı üretemiyor" uyarısı ne demek? Bot günlüğündeki satırları okumak · WordPress yapay zekâ yazı eklentisini silersem yazdığı yazılar da silinir mi? · Yapay zekâ API'sinde araç çağırma (function calling) nasıl yapılır? · Yapay zekâ API bakiyemi koddan nasıl sorgularım, bakiye azalınca nasıl uyarı alırım? · Birden çok WordPress sitesinde aynı yapay zekâ yazı eklentisini tek hesap ve tek bakiyeyle kullanabilir miyim? · Claude Code başka bir API adresi ve anahtarıyla nasıl çalıştırılır? · Yapay zekâyla yazılan WordPress yazılarına SSS bölümü ve FAQ yapısal verisi (schema) eklenir mi? · Yapay zekâ API'si "401 Invalid API key" hatası veriyor: anahtarım neden kabul edilmiyor? · Yapay zekâ API'sinin ücretsiz denemesi var mı? Wiozen API ne kadar deneme bakiyesi veriyor, neyi kapsıyor? · API üzerinden Claude Haiku mı, Claude Sonnet mi? 1 milyon token fiyatı ve hangisinin ne zaman kullanılacağı · Claude Code oturumu API anahtarıyla ne kadar tutar? · Claude Code abonelik olmadan, kullandığın kadar ödeyerek nasıl kullanılır? · Prompt önbelleği API maliyetini ne kadar düşürür? Önbellekten okuma ve yazma fiyatı · DeepSeek API hangi saatlerde daha ucuz? Yoğun saat ve indirimli saat fiyatı · Cline, Cursor, OpenCode ve Aider'da hangi model kullanılmalı? · Yapay zekâyla bir WordPress yazısı kaça mal olur? Metin, görsel ve araştırma maliyeti · Yapay zekâ botunun yazdığı yazı neden yayınlanmadı, taslakta kaldı? · Yapay zekâ botuyla günde kaç yazı yayınlanmalı, sıklık nasıl ayarlanır? · Yapay zekâyla yazılan WordPress yazılarında yazar olarak kim görünmeli? · Kredi, kripto ya da enerji sitesine yapay zekâyla yazı yazdırırken nelere dikkat etmeli? · Yapay zekâ API'si "Unknown model" hatası veriyor: doğru model adını nereden bulurum?