Metin

Çok Modlu Embedding'ler Oluşturun

Çok modlu bir embedding modeliyle embedding vektörleri oluşturur

POST
/v1/multimodal/embeddings

Genel Bakış

Bu uç noktayı, ayrıntılarında multimodal-embedding işlemi listelenen modellerle kullanın. İstek göndermeden önce GET /v1/models/{model} içindeki supported_operations alanını inceleyin. Yalnızca metin destekleyen embedding modelleri Embedding Oluşturun uç noktasını kullanır ve bu uç nokta onlar için 400 unsupported_endpoint döndürür.

Yalnızca metin girişi aktiftir. image_url veya image_base64 içeren bir istek 400 image_input_deferred döndürür.

İstek Gövdesi

modelstringzorunlu

qwen3-vl-embedding gibi, multimodal-embedding işlemini listeleyen bir modelin ID'si.

inputobject | arrayzorunlu

Tek bir girdi öğesi veya öğeler dizisi. Her öğenin aşağıdaki alanlardan en az birine sahip olması gerekir ve yanıt her öğe için bir kayıt içerir.

  • text (string): Embedding'e dönüştürülecek metin.
  • image_url (string): Herkese açık görsel URL'si. Henüz aktif değil.
  • image_base64 (string) ve image_mime_type (string): Base64 görsel verisi ve MIME türü. Henüz aktif değil.
dimensionsinteger

Döndürülen her vektörün boyut sayısı (pozitif bir tam sayı). Maksimum değer modele bağlıdır.

Yanıt

objectstring

Her zaman list.

dataarray

Girdi öğesi başına bir kayıt.

Her kayıt şunları içerir:

  • object (string): embedding
  • index (integer): Girdi öğesinin dizini
  • text_embedding (array): Bir metin öğesinin vektörü. Bir kayıt, modalitesine göre adlandırılan tek bir vektör alanı taşır: text_embedding, image_embedding, video_embedding veya audio_embedding.
modelstring

Kullanılan model.

usageobject

Model tarafından bildirildiğinde prompt_tokens ve total_tokens içeren token kullanımı.

İstek

curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-embedding",
    "input": [
      {"text": "A red bicycle leaning against a brick wall"},
      {"text": "A city street at night"}
    ]
  }'

Örnek vektör okunabilirlik amacıyla kısaltılmıştır.

Yanıt

Response
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
    { "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
  ],
  "model": "qwen3-vl-embedding",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

Hatalar

DurumKodNeden
400invalid_requestinput eksik, boş veya bir öğe text, image_url, image_base64 alanlarından hiçbirine sahip değil
400unsupported_endpointModel multimodal-embedding işlemini listelemiyor
400image_input_deferredBir öğe görsel içeriyor

Diğer durumları API hatalarını ele alma kılavuzunda açıklandığı gibi yönetin.

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json