Embeddings, Rerank ve Konuşmadan Metne

Vektör, yeniden sıralama ve transkripsiyon uçları

RAG ve arama işleri için üç uç: metin gömme (embeddings, OpenAI uyumlu), belgeleri bir sorguya göre yeniden sıralama (rerank, Cohere/Jina tarzı) ve ses dosyasını yazıya dökme (transcriptions, OpenAI uyumlu çok parçalı form). :tr ile biten modeller Türkiye'de barındırılır; sınırları için Türkiye modelleri bölümüne bakın.

Embeddings

POST /v1/embeddings

OpenAI uyumlu gövde: model, input (metin ya da en fazla 128 metinlik dizi) ve isteğe bağlı encoding_format (float varsayılan, base64).

                cURL
                
curl https://api.onysoft.com/v1/embeddings \
  -H "Authorization: Bearer $ONYSOFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "openai/text-embedding-3-small", "input": ["Merhaba dünya", "Yapay zeka API"]}'

                Python
                
emb = client.embeddings.create(model="qwen/qwen3-embedding-8b:tr", input="Merhaba dünya")
print(len(emb.data[0].embedding))

Yalnız girdi tokenları ücretlendirilir. Modeller: openai/text-embedding-3-small, openai/text-embedding-3-large ve qwen/qwen3-embedding-8b:tr. Python örneğindeki client, OpenAI SDK bölümündeki istemcidir; SDK'nın varsayılan encoding_format: "base64" isteği desteklenir.

Rerank

POST /v1/rerank

Gövde: model, query, documents (metin ya da {"text": …} dizisi), isteğe bağlı top_n ve return_documents.

                cURL
                
            

curl https://api.onysoft.com/v1/rerank \
  -H "Authorization: Bearer $ONYSOFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen/qwen3-reranker-8b:tr",
    "query": "İade süresi kaç gün?",
    "documents": ["İade 14 gün içinde yapılır.", "Kargo ücreti alıcıya aittir."],
    "top_n": 1
  }'
            

Yanıt üst düzeydedir (Cohere/Jina SDK'larının beklediği gibi): results dizisinde her belgenin sırası (index) ve puanı (relevance_score) bulunur; ayrıca usage döner. Model: qwen/qwen3-reranker-8b:tr. İstek başına en fazla 100 belge gönderilebilir.

Konuşmadan Metne (Transcriptions)

POST /v1/audio/transcriptions

OpenAI uyumlu çok parçalı form: file (zorunlu), model, isteğe bağlı language (ör. tr), prompt, response_format (json ya da text) ve temperature.

cURL

curl https://api.onysoft.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $ONYSOFT_API_KEY" \
  -F file=@kayit.mp3 \
  -F model=qwen/qwen3-asr-1.7b:tr \
  -F language=tr

Yanıt {"text": "…"} biçimindedir. Model: qwen/qwen3-asr-1.7b:tr. :tr olmayan bir modelle istek 400 alır ve yanıtta doğru kullanım anlatılır; diğer ses modelleri asenkron Audio API üzerinden çalışır. Dosya boyutu ve süre sınırları Türkiye modelleri bölümündedir.