ShareAI Platform Docs

Belgeleri yeniden sıralandır

Bir sorgu ve 1–1000 belge sağlayın.

Markdown olarak görüntüle
Bu sayfada
POST https://api.shareai.now/api/v1/rerank

Belgeleri yeniden sıralandır

Temel URL
https://api.shareai.now
Kimlik doğrulama
Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
Gerekli kapsam
inference or monetization_gateway

Bir sorgu ve 1–1000 belge sağlayın. Her belge bir metin, bir {"text":"..."} nesne veya model destekli bir {"image":"https://..."} nesne olabilir. top_n en az 1 ve belge sayısından büyük olmamalıdır. Sonuçları orijinal belge indeksleriyle eşleştirin.

Başlamadan önce#

SHAREAI_API_KEY'i sunucunuzda ayarlayın ve model yer tutucusunu şu anda etkin olan bir modelle değiştirin. API anahtarını tarayıcı kodunda asla ifşa etmeyin. Model, hesap, kimlik bilgisi ve sağlayıcı bu işlemi izin vermelidir. Aşağıdaki isteğe bağlı ayarlar model desteği gerektirir; API güvenlik sınırları, her modelin her değeri desteklediği anlamına gelmez.

Bir istek gönder#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/rerank" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_RERANK_MODEL",
  "query": "A cat",
  "documents": [
    {
      "text": "A cat on a windowsill."
    },
    {
      "text": "A map of Berlin."
    }
  ],
  "top_n": 1
}'

İstek alanları#

AlanTürAnlam ve sınırlar
model gereklimetin dizisiTam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır.
query gereklimetin dizisiBoş olmayan bir alaka sorgusu.
documents gereklidizi1–1000 boş olmayan metin dizisi veya tek anahtarlı metin/görüntü nesneleri. Görüntü değerleri HTTPS URL'leri veya modelin görüntü girişi desteğiyle uyumlu görüntü veri URL'leri olmalıdır.
top_ntam sayı1 ile belge sayısı arasında isteğe bağlı sonuç sayısı. Döndürülen indeksler orijinal belge dizisine atıfta bulunur.
return_documentsbooleanSonuçta orijinal belgelerin sağlayıcı destekli dahil edilmesi isteğe bağlıdır.
providernesneİsteğe bağlı sağlayıcı yönlendirme tercihleri. Kabul edilen sağlayıcı etiketleri için provider.only kullanın, model kimliğinde bir ön ek olarak değil. Hesap ve kimlik bilgisi kısıtlamaları yine de geçerlidir.

Sonucu okuyun#

Başarı, JSON ile HTTP 200 döndürür. Bir sorgu ve 1–1000 belge sağlayın. Her belge bir metin, bir {"text":"..."} nesne veya model destekli bir {"image":"https://..."} nesne olabilir. top_n en az 1 ve belge sayısından büyük olmamalıdır. Sonuçları orijinal belge indeksleriyle eşleştirin.

Faturalandırma birimleri#

Yeniden sıralama oranları giriş token'larını, puanlanmış belgeleri, istekleri veya sağlayıcı tarafından raporlanan bir arama miktarını kullanabilir. Evrensel bir arama-token dönüşümü varsayılmaz. Fiyatlandırılmış bir boyutu raporlayamayan bir sağlayıcı, o tarife için kullanılamaz.

Konsol'dan tam etkin model tanımlayıcısını seçin. Beyan edilen işlem ve giriş/çıkış yetenekleri bu uç noktayla eşleşmelidir; bir metin sohbet modeli başka bir işlem için değiştirilemez. Kimlik bilgileriniz, sağlayıcı ve hesap kısıtlamaları hala geçerlidir.

Fiyatlandırma ve kullanım#

Oranlar, seçilen model, sağlayıcı, birimler ve varyantlar için EUR AI kredisi olarak yayımlanır. Yalnızca aktif tarifesindeki boyutlar ücretlendirilir. Bir tahmin, yürütmeden önce kredileri ayırır; nihai ücretler ölçülen kullanıma göre hesaplanır. Fiyatlar çözünürlüğe, çıktı formatına veya bir kullanım bandına bağlı olabilir. Nihai ShareAI borçlandırmasını görmek için Konsol Kullanımı'nı kontrol edin. Yukarı akış maliyet alanları ve medya baytları, uydurulmuş token sayısına dönüştürülmez.

Erişim ve hatalar#

Kullan inference onaylanmış ağ maliyeti çıkarımı için veya monetization_gateway onaylanmış bir Builder kar marjı ve kabul edilen faturalandırma şartları için. Yalnızca kimlik doğrulama erişimi harcama yetkisi vermez. Doğrulama, model yetkilendirmesi, yetersiz kredi, oran sınırları ve yürütme hataları yapılandırılmış bir şekilde döner. error. Bir zaman aşımı veya belirsiz gönderimden sonra, başka bir potansiyel ücretli istek oluşturmadan önce Kullanımı veya video işini inceleyin.

Son güncelleme Kasım 3, 2026

ShareAI Platform Belgeleri
Tüm belgeler

Başlık veya içerik ile ara.

Bu sayfa hakkında soru sor

Bu sayfayı keşfetmek için bir asistan seçin. Ayrıca sayfayı kopyalayıp konuşmanıza yapıştırabilirsiniz.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI