Trendyol Asure 12B'de görsel girdi: neden yalnızca base64 data URI

Alışılmış varsayım burada geçerli değil

Birçok görsel destekli sohbet modeli, isteğe hem herkese açık bir görsel URL'si hem de base64 kodlanmış bir görsel gönderme seçeneği sunar. Trendyol Asure 12B'nin model sayfası bu genel varsayımdan ayrılır: görsel girdi yalnızca base64 kodlanmış bir data URI olarak kabul edilir, uzak bir görsel URL'si gönderme desteklenmez.

Başka bir modelle çalışan bir entegrasyonu doğrudan bu modele taşırsanız ve kodunuz bir görsel URL'si gönderiyorsa, istek muhtemelen beklenmedik bir hata döner; bu, modelin görsel girdiyi genel olarak desteklemediği anlamına gelmez, yalnızca görselin isteğe hangi biçimde ekleneceğiyle ilgilidir.

Görseli data URI biçimine nasıl çevirirsiniz

Bir data URI, görselin ham baytlarının base64 ile kodlanıp bir önekle (görselin türünü belirten bir MIME tipiyle) birleştirilmiş hâlidir. Pratikte bu, görsel dosyasını okuyup base64 kodlayan birkaç satırlık bir yardımcı fonksiyon yazmak ve bu diziyi isteğin görsel alanına, uzak bir URL yerine, doğrudan yerleştirmek anlamına gelir.

Görsel yerel bir dosyadan geliyorsa bu dönüşüm doğrudandır. Görsel zaten bir URL'de barınıyorsa (örneğin bir kullanıcının yüklediği ve bir depolama servisinde tuttuğunuz bir dosya), isteği göndermeden önce o URL'den görseli indirip base64'e çevirmeniz gerekir; bu, isteğe ekstra bir ağ çağrısı ve küçük bir gecikme ekler.

• Görsel yalnızca base64 data URI olarak kabul edilir, uzak URL desteklenmez.
• Zaten bir URL'de barınan bir görseli göndermeden önce indirip base64'e çevirmeniz gerekir.
• Bu dönüşüm isteğe küçük bir ek gecikme ekler; büyük görsellerde bunu hesaba katın.

Büyük görsellerde istek boyutunu göz önünde bulundurun

Base64 kodlama, ham görsel boyutunu yaklaşık üçte bir oranında büyütür; yüksek çözünürlüklü bir görsel gönderiyorsanız isteğin toplam boyutu hızla büyüyebilir. Üretime almadan önce tipik görsel boyutunuzla bir istek göndererek toplam yükün makul kaldığını doğrulamak, beklenmedik bir boyut sınırı hatasıyla karşılaşmamanızı sağlar.

Sık sorulan sorular

Zaten elimde bir görsel URL'si varsa bunu doğrudan gönderemez miyim?

Hayır, bu model uzak görsel URL'sini kabul etmez. URL'deki görseli önce indirip base64 data URI biçimine çevirmeniz, ardından bu diziyi isteğe eklemeniz gerekir.

base64 dönüşümü her programlama dilinde aynı mı çalışır?

Temel mantık (ham baytları base64 ile kodlayıp bir MIME tipi öneki eklemek) aynıdır, ama kullanılan kütüphane veya standart fonksiyon dile göre değişir; kendi dilinizin standart base64 kodlama aracını kullanmanız yeterlidir.

İlgili yazılar

• llmtr/trendyol-asure-12b
• Model kataloğu
• Fiyatlandırma