Parallel (web araştırmalı yanıt ve Search)

Parallel iki iş yapar. parallel/parallel soruyu canlı web'de araştırır ve kaynaklarıyla yanıtlar; Chat Completions üzerinden çağrılır. parallel/search ise ajanlar ve uygulamalar için web aramasıdır: /v1/search ucuna hedef ve sorgular gönderilir, sıralı adresler ve alıntılar döner, model yanıtı üretilmez.

Fiyat token değil istek başınadır ve Parallel'in liste fiyatıdır.

Modeller

Model	Uç nokta	Fiyat
parallel/parallel	/v1/chat/completions	Derinliğe göre, aşağıda
parallel/search	/v1/search	Moda göre, aşağıda
parallel/parallel-free	/v1/chat/completions	Ücretsiz
parallel/search-free	/v1/search	Ücretsiz

Ücretsiz kullanım

parallel/parallel-free ve parallel/search-free 4 Ocak 2027 23:59'a (TSİ) kadar ücretsizdir; ücretsiz kullanım için ayrılan kota daha önce biterse ikisi birlikte o tarihten önce kapanır. Hesap başına ücretsiz kullanım sınırlıdır ve iki model aynı hakkı paylaşır. Derin araştırma haktan daha çok düşer.

Dönem bittiğinde bu modeller 410 model_retired döner ve hata mesajı ücretli karşılığını söyler. İstek ücretli modele kendiliğinden yönlendirilmez; devam etmek için model alanını değiştirirsiniz.

Web araştırmalı yanıt

curl "$LLMTR_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "parallel/parallel",
    "reasoning_effort": "low",
    "messages": [
      { "role": "system", "content": "Tek cümleyle yanıtla." },
      { "role": "user", "content": "Galata Kulesi ne zaman yapıldı?" }
    ]
  }'

reasoning_effort araştırma derinliğini seçer. Aynı seçim model adına ek olarak da yazılabilir: parallel/parallel:low.

Derinlik	Fiyat ($/istek)	Ne zaman
low	0,01	Tek adımlı bilgi soruları
medium (varsayılan)	0,05	Birkaç kaynağı birleştiren sorular
high	0,25	Kapsamlı araştırma gerektiren sorular

Derinlik arttıkça yanıt gecikir. high yaklaşık bir dakikayı bulabilir, istemci zaman aşımını buna göre ayarlayın.

Yanıt, Chat Completions biçimindedir. Kaynaklar üst seviyede iki alanda gelir:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "parallel/parallel",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Galata Kulesi 1348'de Cenevizliler tarafından yapıldı." },
      "finish_reason": "stop"
    }
  ],
  "citations": ["https://example.com/galata"],
  "search_results": [{ "url": "https://example.com/galata", "title": "Galata Kulesi" }],
  "usage": { "prompt_tokens": 18, "completion_tokens": 14, "total_tokens": 32 }
}

usage içindeki token sayıları yaklaşıktır ve faturayı etkilemez.

Sınırlar ve davranış:

• Yalnızca metin kabul edilir. Görsel ya da dosya içeren istek 400 alır.
• Mesajlar toplam 20.000 karakteri geçemez ve en az bir kullanıcı mesajı gerekir. Sistem mesajı da bu sayıma girer.
• Konuşma geçmişi messages içinde gönderilir, sunucuda tutulmaz.
• Araç çağrısı yoktur. tools ve tool_choice yok sayılır.
• temperature, top_p, max_tokens gibi alanlar da yok sayılır. Yok sayılan alanların adları yanıttaki llmtr_dropped_parameters alanında ve x-llmtr-dropped-parameters başlığında yazar.
• response_format ile json_schema desteklenir. json_object desteklenmez ve yok sayılır.
• Akış isteği (stream: true) çalışır, ama yanıt araştırma bittikten sonra tek parça olarak gelir.

Web araması

curl "$LLMTR_BASE_URL/v1/search" \
  -H "Authorization: Bearer llmtr-your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "parallel/search",
    "mode": "fast",
    "objective": "Galata Kulesinin tarihi hakkında kaynak bul.",
    "search_queries": ["Galata Kulesi tarihi", "Galata Kulesi yapım tarihi"]
  }'

Alan	Zorunlu	Açıklama
model	Evet	parallel/search ya da parallel/search-free
search_queries	Evet	Kısa anahtar sorgular. İki ya da üç sorgu en iyi sonucu verir; beşinciden sonrası atılır ve warnings içinde bildirilir.
objective	Hayır	Aramanın amacı, doğal dille, en fazla 5.000 karakter
mode	Hayır	turbo, fast, basic, advanced (varsayılan)
max_chars_total	Hayır	Tüm alıntıların toplam karakter üst sınırı
session_id	Hayır	Aynı işe ait aramaları gruplar. Hesabınıza özeldir, başka bir hesabın oturumuyla karışmaz.
client_model	Hayır	Sonuçları tüketecek modelin adı
advanced_settings	Hayır	source_policy, fetch_policy, excerpt_settings, location, max_results
max_budget_usd	Hayır	Ücretli modelde istek için ayrılacak en yüksek tutar

Mod	Fiyat ($/istek)	Yaklaşık süre
turbo	0,001	200 ms
fast	0,001	700 ms
basic	0,005	1 sn
advanced (varsayılan)	0,005	3 sn

Her istek en fazla 10 sonucu içerir. advanced_settings.max_results ile en fazla 20 sonuç istenebilir ve 10'u aşan her sonuç 0,001 $ eder.

{
  "object": "web_search",
  "search_id": "8f14e45f-...",
  "model": "parallel/search",
  "session_id": "session_3a7c...",
  "results": [
    {
      "url": "https://example.com/galata",
      "title": "Galata Kulesi",
      "publish_date": null,
      "excerpts": ["Kule 1348'de Cenevizliler tarafından yapıldı..."]
    }
  ],
  "warnings": null,
  "usage": { "search_requests": 1, "additional_results": 0 }
}

/v1/search OpenAI SDK'larında yoktur, düz HTTP ile çağrılır.

Hatalar

Durum	Tür	Ne yapmalı
400	invalid_request	İstek alanlarını düzeltin
402	insufficient_credits	Ücretli model: bakiye yükleyin
402	insufficient_quota	Ücretsiz model: bu dönemdeki hakkınız bitti
410	model_retired	Ücretsiz dönem bitti, hata mesajındaki modele geçin
429	rate_limit_error	Ücretsiz modelde günlük hak bitti ya da hız sınırı aşıldı, Retry-After kadar bekleyin
503	model_unavailable	Geçici olarak kullanılamıyor, sonra tekrar deneyin

Diğer hata biçimleri için Hatalar sayfasına bakın.

Veri

Bu modeller üçüncü taraf bir sağlayıcı üzerinden sunulur. Sağlayıcının şartlarına göre girdi ve çıktılar kişiyle ilişkilendirilmeden model eğitimi için kullanılabilir ve saklanabilir. Hassas veri göndermeyin.