Görüntü işleme modellerini sorgulama

Bu makalede, görüntü işleme görevleri için iyileştirilmiş ve Unity AI Gateway tarafından sunulan temel modeller için sorgu istekleri yazmayı öğreneceksiniz.

Tip

Genie Code (Aracı modu) bunu sizin için yapabilir. Şu örnek istemi deneyin:

Query the databricks-claude-sonnet-4-5 model using the OpenAI client, sending a base64-encoded image from a URL alongside a text question, and print the response.

Model Sunma, çeşitli temel modelleri kullanarak görüntüleri anlamak ve analiz etmek için birleştirilmiş bir API sağlar ve güçlü çok modüllü özelliklerin kilidini açar. Bu işlev, Temel Model API'lerinin bir parçası olarak belirli Databricks tarafından barındırılan modeller ve dış modellere hizmet veren uç noktalar aracılığıyla kullanılabilir.

Gereksinimler

Sorgu örnekleri

Uyarı

Aşağıdaki örnekler Unity AI Gateway ve model hizmetlerini temel alır. Model hizmetleri yerine uç noktaları sunan model kullanıyorsanız, model hizmeti adını bir uç nokta adıyla değiştirin. Kullanılabilir temel modellerin ve bunların model hizmeti ve uç nokta adlarının listesi için bkz. Temel Model API'lerinde bulunan Databricks tarafından barındırılan temel modeller.

OpenAI istemcisi

OpenAI istemcisini kullanmak için giriş olarak model model hizmeti adını belirtin.


from openai import OpenAI
import base64
import requests

# Get the workspace API URL and token from the notebook context
API_ROOT = dbutils.notebook.entry_point.getDbutils().notebook().getContext().apiUrl().get()
API_TOKEN = dbutils.notebook.entry_point.getDbutils().notebook().getContext().apiToken().get()

client = OpenAI(
    api_key=API_TOKEN,
    base_url=f"{API_ROOT}/ai-gateway/mlflow/v1",
)

# Download and encode image
image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
resp = requests.get(image_url)
resp.raise_for_status()
image_data = base64.b64encode(resp.content).decode("utf-8")

# OpenAI request
completion = client.chat.completions.create(
    model="system.ai.claude-sonnet-4-5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "what's in this image?"},
                {
                    "type": "image_url",
                    "image_url": {"url": f"data:image/jpeg;base64,{image_data}"},
                },
            ],
        }
    ],
)

print(completion.choices[0].message.content)

Chat Completions API'si, birden fazla görüntü girişi destekler ve modelin her bir resmi analiz etmesine ve verilen komuta bir yanıt oluşturmak için tüm girdilerden bilgi sentezlemesine olanak tanır.


from openai import OpenAI
import base64
import requests

# Get the workspace API URL and token from the notebook context
API_ROOT = dbutils.notebook.entry_point.getDbutils().notebook().getContext().apiUrl().get()
API_TOKEN = dbutils.notebook.entry_point.getDbutils().notebook().getContext().apiToken().get()

client = OpenAI(
    api_key=API_TOKEN,
    base_url=f"{API_ROOT}/ai-gateway/mlflow/v1",
)

# Download and encode multiple images
image1_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
resp1 = requests.get(image1_url)
resp1.raise_for_status()
image1_data = base64.b64encode(resp1.content).decode("utf-8")

image2_url = "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg"
resp2 = requests.get(image2_url)
resp2.raise_for_status()
image2_data = base64.b64encode(resp2.content).decode("utf-8")

# OpenAI request
completion = client.chat.completions.create(
    model="system.ai.claude-sonnet-4-5",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What are in these images? Is there any difference between them?"},
                {
                    "type": "image_url",
                    "image_url": {"url": f"data:image/jpeg;base64,{image1_data}"},
                },
                {
                    "type": "image_url",
                    "image_url": {"url": f"data:image/jpeg;base64,{image2_data}"},
                },
            ],
        }
    ],
)

print(completion.choices[0].message.content)

SQL

Önemli

Aşağıdaki örnek, ai_query yerleşik SQL işlevini kullanır. Bu işlev Genel Önizleme aşamasındadır ve tanım değişebilir.

Aşağıda, Databricks Foundation Model API'leri tarafından desteklenen bir temel model, AI İşlevi ai_query() kullanılarak çok modlu giriş için sorgulanmaktadır.


> SELECT *, ai_query(
  'system.ai.llama-4-maverick',
 'what is this image about?', files => content)
as output FROM READ_FILES("/Volumes/main/multimodal/unstructured/image.jpeg");

Desteklenen modeller

Desteklenen görme modelleri için Temel model türlerine bakın.

Giriş görüntüsü gereksinimleri

Model(ler) Desteklenen biçimler İstek başına birden fazla görüntü Görüntü boyutu sınırlamaları Görüntü yeniden boyutlandırma önerileri Görüntü kalitesiyle ilgili dikkat edilmesi gerekenler
databricks-gpt-5
  • JPEG
  • PNG
  • WebP
  • GIF (Animasyonsuz GIF)
İstek başına en fazla 500 ayrı görüntü girişi Dosya boyutu sınırı: İstek başına en fazla 10 MB toplam yük boyutu N/A
  • Filigran veya logo yok
  • Bir insanın anlaması için yeterince açık
databricks-gpt-5-mini
  • JPEG
  • PNG
  • WebP
  • GIF (Animasyonsuz GIF)
İstek başına en fazla 500 ayrı görüntü girişi Dosya boyutu sınırı: İstek başına en fazla 10 MB toplam yük boyutu N/A
  • Filigran veya logo yok
  • Bir insanın anlaması için yeterince açık
databricks-gpt-5-nano
  • JPEG
  • PNG
  • WebP
  • GIF (Animasyonsuz GIF)
İstek başına en fazla 500 ayrı görüntü girişi Dosya boyutu sınırı: İstek başına en fazla 10 MB toplam yük boyutu N/A
  • Filigran veya logo yok
  • Bir insanın anlaması için yeterince açık
databricks-gemma-3-12b
  • JPEG
  • PNG
  • WebP
  • GIF
API istekleri için en fazla 5 görüntü
  • Sağlanan tüm görüntüler bir istekte işlenir.
Dosya boyutu sınırı: API isteği başına tüm görüntülerde toplam 10 MB N/A N/A
databricks-llama-4-maverick
  • JPEG
  • PNG
  • WebP
  • GIF
API istekleri için en fazla 5 görüntü
  • Sağlanan tüm görüntüler bir istekte işlenir.
Dosya boyutu sınırı: API isteği başına tüm görüntülerde toplam 10 MB N/A N/A
  • databricks-claude-sonnet-5
  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-haiku-4-5
  • databricks-claude-opus-4-8
  • databricks-claude-opus-4-7
  • databricks-claude-opus-4-6
  • databricks-claude-opus-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4
  • JPEG
  • PNG
  • GIF
  • WebP
  • Claude.ai için en fazla 20 resim
  • API istekleri için en fazla 100 görüntü
  • Sağlanan tüm görüntüler bir istekte işlenir, bu da onları karşılaştırmak veya zıtlaştırmak için faydalı olur.
  • 8000x8000 pikselden büyük görüntüler reddedilir.
  • Bir API isteğinde 20'den fazla görüntü gönderiliyorsa, görüntü başına izin verilen boyut üst sınırı2000 x 2000 pikseldir.
Optimal performans için, eğer çok büyüklerse, yüklemeden önce resimlerin boyutunu yeniden ayarlayın.
  • Görüntünün uzun kenarı 1568 pikseli aşıyorsa veya boyutu yaklaşık 1.600 birimi aşıyorsa, en boy oranı korunarak otomatik olarak ölçeklendirilir.
  • Çok küçük görüntüler ( herhangi bir kenarda 200 pikselin altında) performansı düşürebilir.
  • Gecikme süresini azaltmak için görüntüleri her iki boyutta da 1,15 megapiksel ve en fazla 1568 piksel içinde tutun.
  • Netlik: Bulanık veya pikselli görüntülerden kaçının.
  • Görüntülerdeki metin:
    • Metnin okunaklı olduğundan ve çok küçük olmadığından emin olun.
    • Yalnızca metni büyütmek için önemli görsel bağlamını kırpmaktan kaçının.

Görüntüden belirteçe dönüştürme

Bu bölüm yalnızca Temel Model API'leri için geçerlidir. Dış modeller için sağlayıcının belgelerine bakın.

Temel modele yapılan bir istekteki her görüntü, jeton kullanımınıza katkıda bulunur. Kullandığınız belirteç kullanımına ve modeline göre görüntü fiyatlandırmasını tahmin etmek için fiyatlandırma hesaplayıcısına bakın.

Görüntü anlama sınırlamaları

Bu bölüm yalnızca Temel Model API'leri için geçerlidir. Dış modeller için sağlayıcının belgelerine bakın.

Desteklenen Databricks tarafından barındırılan temel modellerinin görüntü anlama sınırlamaları aşağıdadır:

Model Sınırlamalar
Aşağıdaki Claude modelleri desteklenir:
  • databricks-claude-sonnet-5
  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4
Databricks'te Claude modellerinin sınırları şunlardır:
  • İnsan gözetimi olmadan mükemmel hassasiyet veya hassas analiz gerektiren görevler için Claude kullanmaktan kaçının.
  • Kişi belirleme: Görüntülerdeki kişiler tanımlanamaz veya adlandırılamaz.
  • Doğruluk: Düşük kaliteli, döndürülmüş veya çok küçük görüntüleri (200 piksel) yanlış yorumlanabilir.
  • Uzamsal mantık: Analog saatleri veya satranç pozisyonlarını okuma gibi hassas düzenlerle mücadele eder.
  • Sayma: Yaklaşık sayımlar sağlar, ancak birçok küçük nesne için yanlış olabilir.
  • Yapay zeka tarafından oluşturulan görüntüler: Yapay veya sahte görüntüleri güvenilir bir şekilde algılayamaz.
  • Uygunsuz içerik: Açık veya ilkeyi ihlal eden görüntüleri engeller.
  • Sağlık: Karmaşık tıbbi taramalar için uygun değildir (örneğin, CT'ler ve MR'ler). Bu bir tanılama aracı değil.

Ek kaynaklar