Metin gömüleri oluştur
ShareAI ile anlamsal arama, geri getirme ve benzerlik için desteklenen giriş formatları ve model gereksinimleriyle metin gömüleri oluşturun.
Bu sayfada
https://api.shareai.now/api/v1/embeddingsBir veya daha fazla metni gömme vektörlerine dönüştürün.
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
ShareAI'de etkinleştirilmiş ve kimlik bilgileriniz tarafından izin verilen bir gömme modelini seçin. Sohbet modelleri gömme modelleriyle değiştirilemez. Modelin kullanılabilirliği ve desteklenen seçenekler yapılandırılmış sağlayıcıya bağlıdır.
Bir istek gönder#
cURL
curl --fail-with-body --request POST \
"https://api.shareai.now/api/v1/embeddings" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
}'
Python
import json
import os
import urllib.request
headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_EMBEDDING_MODEL', 'input': ['How do I connect a device?', 'Where can I read my usage?'], 'encoding_format': 'float'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/embeddings', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=60) as response:
print(json.load(response))
TypeScript
const url = "https://api.shareai.now/api/v1/embeddings";
const headers: Record = {
Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
"model": "YOUR_EMBEDDING_MODEL",
"input": [
"How do I connect a device?",
"Where can I read my usage?"
],
"encoding_format": "float"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
İstek alanları#
| Alan | Değer |
|---|---|
model | Etkinleştirilmiş bir gömme model kimliği. |
input | Boş olmayan bir dize veya en fazla 128 boş olmayan diziden oluşan bir dizi. |
encoding_format | float veya base64. |
dimensions | 1 ile 65536 arasında isteğe bağlı bir tamsayı; seçilen model bunu desteklemelidir. |
Vektörleri oku#
Oku data diziyi kullanın ve her sonucun index gömmesini girdiye eşleştirin. Belgelerinizi ve arama sorgularınızı gömerken aynı modeli ve boyutları kullanın. Sonuç ayrıca sağlayıcı tarafından raporlanan usage.
Sınırlar dahilinde toplu işlem#
Birleştirilmiş giriş metni 256 KiB ile sınırlıdır. Yanıtlar eşzamanlıdır ve 2 MiB ile sınırlıdır, bu nedenle büyük vektörler veya toplu işlemler yanıt sınırını aşabilir. Toplu işlem boyutunu küçültün veya desteklenen daha küçük boyutları kullanın. Token-ID dizileri kabul edilmez.
Kimlik doğrulama ve kullanılabilirlik#
Onaylanmış bir OAuth erişim belirteci, API anahtarının yerine kullanılabilir. Hesap tarafından finanse edilen istekler surcharge ve kabul edilmiş bir plan gerektirir. Model ve sağlayıcı kısıtlamaları hala geçerlidir. Model gömme için etkinleştirilmemişse, mevcut bir gömme modeli seçin; kimlik bilgisini değiştirmek bir modeli etkinleştiremez.
Kullanım#
Gömme işlemleri giriş tokenlarını tüketir. Büyük bir toplu işlem çalıştırmadan önce model fiyatlandırmasını kontrol edin ve Konsol Kullanımı etkinliği gözden geçirin. Yeniden denemeden önce doğrulama, yetkilendirme ve kullanılabilirlik hatalarını ele alın.
Son güncelleme Eylül 15, 2026