Başvuru: Resim Ekleme | Azure Machine Learning

Makale
05/30/2024

Giriş görüntüsünü ve metin çiftini temsil eden bir ekleme vektöru oluşturur.

POST /images/embeddings?api-version=2024-04-01-preview

URI Parametreleri

Veri Akışı Adı	İçinde	Zorunlu	Türü	Açıklama
api-sürümü	query	Doğru	Dize	API'nin "YYYY-AA-GG" veya "YYYY-AA-GG-önizleme" biçimindeki sürümü.

İstek Gövdesi

Veri Akışı Adı	Zorunlu	Türü	Açıklama
input	True	EmbeddingInput[]	Eklemek için giriş resmi. Tek bir isteğe birden çok giriş eklemek için bir dizi geçirin. Giriş, model için maksimum giriş belirteçlerini aşmamalıdır.
boyutlar		integer	Sonuçta elde edilen çıktı eklemelerinin sahip olması gereken boyut sayısı. Null değerinin geçirilmesi, modelin varsayılan değerini kullanmasına neden olur. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.
encoding_format		EmbeddingEncodingFormat	Eklemelerin döndürüleceği biçim. Base64, float, int8, uint8, binary veya ubinary. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.

Yanıtlar

Adı	Tür	Açıklama
200 Tamam	CreateEmbeddingResponse	Tamam
401 Yetkisiz	UnauthorizedError	Erişim belirteci eksik veya geçersiz Üst Bilgiler x-ms-error-code: dize
404 Bulunamadı	NotFoundError	Model tarafından desteklenmeyen modalite. Hangi yolların kullanılabilir olduğunu görmek için modelin belgelerine bakın. Üst Bilgiler x-ms-error-code: dize
422 İşlenemeyen Varlık	UnprocessableContentError	İstek işlenemez içerik içeriyor Üst Bilgiler x-ms-error-code: dize
429 Çok Fazla İstek Var	TooManyRequestsError	Atanan hız sınırınıza ulaştınız ve isteğinizin ilerlemesi gerekiyor. Üst Bilgiler x-ms-error-code: dize
Diğer Durum Kodları	ContentFilterError	Hatalı istek Üst Bilgiler x-ms-error-code: dize

Güvenlik

Yetkilendirme

Ön eki olan Bearer: belirteç, örneğin. Bearer abcde12345

Tür: apiKey
Içinde: üst bilgi

AADToken

Azure Active Directory OAuth2 kimlik doğrulaması

Tür: oauth2
Akış: uygulama
Belirteç URL'si: https://login.microsoftonline.com/common/oauth2/v2.0/token

Örnekler

Giriş metnini ve görüntüsünü temsil eden bir ekleme vektöru oluşturur

Örnek İstek

POST /images/embeddings?api-version=2024-04-01-preview

{
  "input": [
    {
      "text": "A nice picture of a cat",
      "image": "data:image/jpeg;base64,iVBORw0KG..."
    }
  ],
  "encoding_format": "float",
  "dimensions": 1024
}

Örnek Yanıtı

Durum kodu: 200

{
  "data": [
    {
      "index": 0,
      "object": "embedding",
      "embedding": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ]
    }
  ],
  "object": "list",
  "model": "DINO",
  "usage": {
    "prompt_tokens": 15,
    "total_tokens": 15
  }
}

Tanımlar

Veri Akışı Adı	Açıklama
ContentFilterError	İstem yapılandırıldığı gibi bir içerik filtresi tetiklediğinde API çağrısı başarısız olur. İstemi değiştirin ve yeniden deneyin.
CreateEmbeddingResponse
CreateImageEmbeddingRequest
Ayrıntı
Ekleme	Oluşturulan bir görüntüyü temsil eder.
EmbeddingEncodingFormat	Eklemelerin döndürüleceği biçim. Base64, float, int8, uint8, binary veya ubinary. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.
EmbeddingObject	Her zaman "ekleme" olan nesne türü.
EmbeddingInput	İsteğe bağlı metin içeren bir görüntüyü temsil eder.
Listobject	Her zaman "list" olan nesne türü.
NotFoundError
TooManyRequestsError
UnauthorizedError
UnprocessableContentError
Kullanım	İsteğin kullanım bilgileri.

ContentFilterError

İstem yapılandırıldığı gibi bir içerik filtresi tetiklediğinde API çağrısı başarısız olur. İstemi değiştirin ve yeniden deneyin.

Adı	Tür	Açıklama
kod	Dize	Hata kodu.
error	Dize	Hata açıklaması.
ileti	Dize	Hata iletisi.
param	Dize	İçerik filtresini tetikleyen parametre.
durum	integer	HTTP durum kodu.

CreateEmbeddingResponse

Adı	Tür	Açıklama
veriler	Ekleme[]	Model tarafından oluşturulan eklemelerin listesi.
model	Dize	Eklemeyi oluşturmak için kullanılan modelin adı.
nesne	Listobject	Her zaman "list" olan nesne türü.
kullanım	Kullanım	İsteğin kullanım bilgileri.

CreateImageEmbeddingRequest

Adı	Türü	Varsayılan Değer	Açıklama
boyutlar	integer		Sonuçta elde edilen çıktı eklemelerinin sahip olması gereken boyut sayısı. Null değerinin geçirilmesi, modelin varsayılan değerini kullanmasına neden olur. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.
encoding_format	EmbeddingEncodingFormat	kayan noktalı sayı	Eklemelerin döndürüleceği biçim. Base64, float, int8, uint8, binary veya ubinary. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.
input	EmbeddingInput[]		Eklemek için giriş resmi. Tek bir isteğe birden çok giriş eklemek için bir dizi geçirin. Giriş, model için maksimum giriş belirteçlerini aşmamalıdır.

Ayrıntı

Adı	Tür	Açıklama
Loc	string[]	Soruna neden olan parametre
değer	Dize	Parametreye geçirilen değer sorunlara neden oluyor.

Ekleme

Oluşturulan bir görüntüyü temsil eder.

Adı	Tür	Açıklama
Katıştırma	sayı[]	Kayanların listesi olan ekleme vektörünün adı. Vektör uzunluğu kullanılan modele bağlıdır.
dizin	integer	Eklemeler listesindeki ekleme dizini.
nesne	EmbeddingObject	Her zaman "ekleme" olan nesne türü.

EmbeddingEncodingFormat

Eklemelerin döndürüleceği biçim. Base64, float, int8, uint8, binary veya ubinary. Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.

Adı	Tür	Açıklama
base64	Dize
ikili	Dize
kayan noktalı sayı	Dize
int8	Dize
ubinary	Dize
uint8	Dize

EmbeddingObject

Her zaman "ekleme" olan nesne türü.

Adı	Tür	Açıklama
Katıştırma	Dize

EmbeddingInput

İsteğe bağlı metin içeren bir görüntüyü temsil eder.

Adı	Tür	Açıklama
görüntü	Dize	Dizede veri URL'si `base64` olarak kodlanmış giriş görüntüsü. Örnek: `data:image/{format};base64,{data}`.
text	Dize	isteğe bağlı. Modele beslemek için metin girişi (DINO, CLIP gibi). Model değeri veya parametreyi desteklemiyorsa 422 hatası döndürür.

Listobject

Her zaman "list" olan nesne türü.

Adı	Tür	Tanım
listele	Dize

NotFoundError

Adı	Tür	Açıklama
error	Dize	Hata açıklaması.
ileti	Dize	Hata iletisi.
durum	integer	HTTP durum kodu.

TooManyRequestsError

Adı	Tür	Açıklama
error	Dize	Hata açıklaması.
ileti	Dize	Hata iletisi.
durum	integer	HTTP durum kodu.

UnauthorizedError

Adı	Tür	Açıklama
error	Dize	Hata açıklaması.
ileti	Dize	Hata iletisi.
durum	integer	HTTP durum kodu.

UnprocessableContentError

Adı	Tür	Açıklama
kod	Dize	Hata kodu.
Ayrıntı	Ayrıntı
error	Dize	Hata açıklaması.
ileti	Dize	Hata iletisi.
durum	integer	HTTP durum kodu.

Kullanım

İsteğin kullanım bilgileri.

Adı	Tür	Açıklama
prompt_patches	integer	Görüntü istemi tarafından kullanılan görüntü düzeltme eklerinin sayısı.
prompt_tokens	integer	İstem tarafından kullanılan belirteç sayısı.
total_patches	integer	İstek tarafından kullanılan düzeltme eklerinin toplam sayısı.
total_tokens	integer	İstek tarafından kullanılan toplam belirteç sayısı.

Aracılığıyla paylaş