Gömmeler
OpenAI uyumlu bir istekle yerleştirme yanıtlarını kullanın.
Anahtarları sunucu tarafında ve kullanımı görünür tutarken, döndürülen vektörlerle arama, alma, kümeleme ve öneri iş akışlarına yönelik istek ve yanıt işlemeyi kontrol edin.
Son güncelleme: July 12, 2026. Examples kullanım safe placeholders ve yap değil içerir real API anahtarıs, gizli bilgiler, veya customer veri.
Önerilen ilk kullanım
Küçük bir grupla başlayın, vektörleri kaynak meta verileriyle birlikte depolayın, ardından büyük bir derlemi dizine eklemeden önce sıraya koyma, yeniden denemeler ve hız sınırı izleme ekleyin.
Kurulum yolu
Metinden döndürülen vektör şekline dört adım.
Step 1
Sunucu tarafı kimlik doğrulaması
Güvenilir sunucu tarafı kodundan eklemeler:yazma kapsamı ile bir API anahtarı kullanın.
Bölümü açStep 2
Metin girişi gönder
OpenAI uyumlu yerleştirme uç noktasına bir dize veya bir dizi dize gönderin.
Bölümü açStep 3
Meta verilerle vektörleri okuyun
Döndürülen vektör şeklini belge kimliğiniz, kaynağınız ve ürününüzün ihtiyaç duyduğu arama filtreleriyle doğrulayın.
Bölümü açStep 4
Kullanımı izleyin
Büyük indeksleme işlerinden önce istek sayısını, bilgi istemi belirteçlerini, oran durumunu ve 429 yanıtı izleyin.
Bölümü açUç nokta
Metni yerleştirme uç noktasına gönderin.
Kapsamlı bir sunucu tarafı anahtarıyla OpenAI uyumlu /v1 uç noktasını kullanın. Veri politikanız izin vermediği sürece ham içeriği günlüklerin dışında tutun.
| Öğe | Değer | Notlar |
|---|---|---|
| Yöntem | POST | Yerleştirme uç noktasına JSON gönderin. |
| Uç nokta | https://unlimitedcodex.com/v1/embeddings | Sohbet tamamlama ve resim isteği doğrulamayla aynı /v1 tabanını URL kullanın. |
| Yetkilendirme | Hamiline ait jeton | Yerleştirmeler:yazma erişimiyle kapsamlı bir API anahtarı kullanın. |
| İçerik türü | uygulama/json | İstek gövdesi geçerli olmalıdır: JSON. |
Şekil iste
Bir girdi veya küçük bir toplu iş gönderin.
En küçük yararlı istek bir model ve girdiyi içerir. İstemciniz döndürülen her dizini bir kaynak kaydıyla eşleyebildiğinde dizi girişini kullanın.
| Alan | Durum | Notlar |
|---|---|---|
| modeli | Önerilen | Bir ekleme modeli değerini açıkça iletin. Teslim ettiğiniz kurulum ayrıntılarındaki model değerini kullanın. |
| giriş | Gerekli | Boş olmayan bir dize veya boş olmayan dizelerden oluşan bir dizi gönderin. |
| kodlama_formatı | İsteğe bağlı | Depolama katmanınız kodlanmış bir veri yükünü tercih ettiğinde sayısal vektörler için float'ı veya base64'ü kullanın. |
const response = await fetch("https://unlimitedcodex.com/v1/embeddings", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UCX_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "ucx-embedding-3-small",
input: [
"Release checklist for a safe API launch.",
"Rate states and usage review before rollout."
],
encoding_format: "float"
})
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.code ?? "embedding_request_failed");
}
const vectors = body.data.map((item) => item.embedding);Tepki şekli
Vektörü ve kaynak bağlamını birlikte saklayın.
Yanıt, girdi başına bir yerleştirme nesnesinin yanı sıra raporlama ve maliyet incelemesi için kullanım alanlarını içerir.
| Alan | Anlamı | Notlar |
|---|---|---|
| nesne | liste | Yanıtı, yerleştirme nesnelerinin bir listesi olarak tanımlar. |
| veri[].yerleştirme | sayı[] veya base64 | İstenen encoding_format ile eşleşir. |
| veri[].dizin | giriş konumu | Dizi girişlerini tekrar kaynak kayıtlara eşlemek için bunu kullanın. |
| kullanım.prompt_tokens | giriş belirteci sayısı | Kullanım raporlaması ve hız sınırı incelemesi için kullanılan metin hacmini sayar. |
{
"object": "list",
"id": "embd_example",
"model": "ucx-embedding-3-small",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [0.1221, -0.7442, 0.0314]
}
],
"usage": {
"prompt_tokens": 18,
"total_tokens": 18
}
}{
"model": "ucx-embedding-3-small",
"input": "Short text to index.",
"encoding_format": "base64"
}Sınırlar ve hatalar
Dizin oluşturmayı hıza duyarlı bir iş olarak ele alın.
Bir yapı değiştiğinde iş yüklerini yerleştirme hızla büyüyebilir. Dizin oluşturma hattınıza ilerleme takibi, yeniden denemeler ve oran kontrolleri ekleyin.
Uç nokta, OpenAI uyumlu vektörler döndürerek ekiplerin daha büyük iş yüklerini yerleştirmeden önce ayrıştırma, kullanım raporlaması ve depolama davranışını doğrulayabilmesini sağlar.
Ekleme istekleri, bir istek artı bilgi istemi belirteçleri olarak sayılır.
Dizi girişi küçük gruplar için kullanışlıdır, ancak büyük dizin oluşturma işlerinde kendi kuyruğunuz ve geri çekilmeniz kullanılmalıdır.
Uç nokta tam liste yanıtı döndürür; yerleştirmelerin akışı sağlanmaz.
Büyük bir derlemi indekslemeden önce hız sınırı kılavuzundaki 429 işlemeyi kullanın.
Sözleşmeniz bu kullanıma izin vermediği sürece gizli bilgileri, yasal düzenlemelere tabi verileri veya müşteri metinlerini göndermeyin.
SSS
Gömme soruları.
Bir yerleştirme isteğinde birden fazla metin gönderebilir miyim?
Evet. Giriş alanı boş olmayan bir dizeyi veya boş olmayan dizelerden oluşan bir diziyi kabul eder. Yanıt, döndürülen her yerleştirme için bir dizin içerir.
Bir yerleştirme anahtarının hangi kapsama ihtiyacı vardır?
Gömmeler:yazma kapsamıyla bir API anahtarı kullanın. Anahtarı sunucu tarafında tutun ve Taşıyıcı jetonu olarak gönderin.
Yerleştirmeler yayınlanıyor mu?
Hayır. Yerleştirme uç noktası, veri ve kullanım alanlarıyla birlikte tam bir liste yanıtı döndürür.
Büyük indeksleme işlerini nasıl halletmeliyim?
Çalışmayı küçük gruplara ayırın, ilerlemeyi kendi sisteminizde saklayın, geri çekilme ile geçici arızaları yeniden deneyin ve kapasite değişene kadar hız basıncını duraklatın.
Ücretsiz araçlar
Yerleştirme iş yüklerini doğrulama ve tahmin etme
Üretim verilerini endekslemeden önce yükleri doğrulayın, belirteçleri tahmin edin, kota basıncını modelleyin ve maliyetleri karşılaştırın.
Doğrulayıcı Talep Et
Sohbet, yerleştirmeler ve resim JSON verilerini unlimitedcodex OpenAI uyumlu kurallara göre doğrulayın.
Token Tahmincisi
Kota planlaması ve lansmanından önce bilgi istemi veya yanıt metninden belirteç hacmini tahmin edin.
Kota Tahmincisi
MAU ve bilgi istemi varsayımlarını aylık belirteçlere, isteklere ve kota eşiği uyarılarına dönüştürün.
Maliyet Hesaplayıcı
OpenAI aylık harcamayı tahmin edin ve bunu sabit unlimitedcodex haftalık veya aylık paketlerle karşılaştırın.
Sonraki adım
Yerleştirmeleri kimlik doğrulama, hız sınırları ve hata işlemeyle eşleştirin.
Müşteriye yönelik içeriği dizine eklemeden önce temel kapsamı, veri işleme kurallarını, hız sınırı davranışını ve yeniden deneme politikasını onaylayın.