Ücretsiz Qwen3.8 27B'ye görsel gönderme: API rehberi

Kısa yanıt: görseli image_url parçasıyla gönderin

LLMTR, farklı sağlayıcıların dil modellerine tek bir OpenAI uyumlu API ile erişim veren bir gateway'dir. Ücretsiz Qwen3.8 27B'yi burada qwen/qwen3.8-27b-free model kimliğiyle, https://llmtr.com/v1 adresindeki /v1/chat/completions uç noktasından çağırırsınız. Görseli mesajın content dizisine image_url parçası olarak koyar, sorunuzu yanına bir text parçası olarak yazarsınız; cevap metin olarak döner.

Model kartı bu satır için metin girdisinin yanında görsel girdiyi, araç çağırmayı ve JSON modunu listeler. Satır günlük kullanım kotasıyla ücretsizdir: 1 milyon token başına girdi de çıktı da 0 $'dır. Bağlam penceresi 131.042 token, tek yanıtta üretilebilecek çıktı en fazla 16.384 token'dır. Qwen, Qwen3.8-27B'yi görselleri ve videoları anlayan yerel bir görsel-dil modeli olarak tanımlar; LLMTR'deki bu satırda görsel girdi açıktır, video girdisi açık değildir.

• Qwen, Qwen3.8-27B model card · 2026-10-17

Ücretsiz Qwen3.8 27B'ye görsel nasıl gönderilir?

LLMTR'de bir API anahtarı oluşturun ve onu LLMTR_API_KEY ortam değişkeninde saklayın. OpenAI istemcisinin base_url değerini https://llmtr.com/v1 yapın, model olarak qwen/qwen3.8-27b-free yazın. Aşağıdaki Python örneği yerel bir fiş görselini okur, base64'e çevirir ve data:image/png;base64, önekiyle bir data URL olarak gönderir. JPEG bir dosya gönderecekseniz öneki data:image/jpeg;base64, yapın.

Kullanıcı mesajının content alanı bu kez bir dizidir: bir text parçası ve bir image_url parçası. Cevap choices[0].message.content alanında, token sayıları usage içinde gelir. Görsel de istemin bir parçasıdır ve bağlam penceresinden yer kaplar. finish_reason değeri length ise cevap max_tokens sınırında kesilmiştir; sınırı yükseltin (en fazla 16.384) ya da daha kısa bir cevap isteyin.

Örnek, ücretsiz kullanım sınırına ulaşıldığında gelen 429 yanıtını da yakalar ve Retry-After başlığını yazdırır. Böylece betik sessizce durmaz, ne kadar beklemeniz gerektiğini söyler. OpenAI uyumlu başka bir SDK ya da curl kullanıyorsanız istek gövdesi aynıdır: messages dizisindeki kullanıcı mesajı bir text ve bir image_url parçası taşır, Authorization başlığında da LLMTR anahtarınız bulunur.

Yerel bir görseli base64 data URL olarak qwen/qwen3.8-27b-free'ye gönderen, cevabı, finish_reason durumunu ve token kullanımını yazdıran OpenAI Python SDK örneği.

import base64
import os

from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://llmtr.com/v1", api_key=os.environ["LLMTR_API_KEY"])

with open("receipt.png", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode("ascii")

try:
    response = client.chat.completions.create(
        model="qwen/qwen3.8-27b-free",
        messages=[
            {
                "role": "user",
                "content": [
                    {"type": "text", "text": "What is the total amount on this receipt? Answer in one line."},
                    {"type": "image_url", "image_url": {"url": f"data:image/png;base64,{image_b64}"}},
                ],
            }
        ],
        max_tokens=512,
    )
except RateLimitError as err:
    print("Free usage limit reached, Retry-After:", err.response.headers.get("retry-after"))
    raise SystemExit(1)

choice = response.choices[0]
print(choice.message.content)
if choice.finish_reason == "length":
    print("The answer stopped at max_tokens.")
print(response.usage)

Bu satırda hangi girdiler açık?

image_url parçası kabul edilir. video_url ve input_audio parçaları, bu satırda video ve ses girdisi olmadığı için 400 unsupported_input ile döner ve istek sağlayıcıya gitmez. max_tokens 16.384'ü aşarsa istek 400 invalid_request alır; hata mesajı izin verilen üst sınırı yazar.

reasoning_effort bu satırda yoktur: alan gönderilirse istek 400 invalid_request ile döner. Görselle ilgili sorularda düşünme seviyesi yerine soruyu açık yazmak işe yarar: ne istediğinizi, cevabın biçimini ve uzunluğunu tek cümlede söyleyin. Tablo bu satırın katalogdaki değerlerini gösterir.

Görsel isteklerinde dikkat edilecekler

Chat Completions durumsuzdur: çok turlu bir konuşmada önceki mesajları, içlerindeki görsellerle birlikte, her istekte yeniden gönderirsiniz. Görseller biriktikçe 131.042 token'lık bağlamı paylaşırlar. Sonraki turlarda artık gerekmeyen görselleri geçmişten çıkarın, yalnızca konuyla ilgili olanı bırakın.

Görselin istemde ne kadar yer tuttuğunu görmek isterseniz aynı soruyu bir kez görselsiz, bir kez görselle gönderin ve iki yanıttaki usage.prompt_tokens değerlerini karşılaştırın; aradaki fark görselin payıdır. Bu satırda token'lar ücretlendirilmez, ama bağlam penceresinden yer kaplar ve uzun bir konuşmada sınıra beklediğinizden önce yaklaşmanıza yol açabilir.

Soruyu net kurun: text parçasında neyi sorduğunuzu, beklediğiniz biçimi (tek satır, liste ya da sayı) ve cevabın dilini yazın. Görselin soruyla ilgisi olmayan kenarlarını kırpmak ve metin okutacaksanız yazının okunur kaldığı bir çözünürlükte göndermek de cevabı sadeleştirir. Türkçe cevap istiyorsanız bunu soruda açıkça belirtin.

Bir görselden alanları yapılandırılmış biçimde çıkarmak istiyorsanız model kartının bu satırda listelediği JSON modunu deneyin. Aynı serideki JSON yazısı response_format ile JSON nesnesi istemeyi ve sonucu kodda doğrulamayı adım adım anlatır; görselli istekte de aynı doğrulamayı kullanın.

Ücretsiz kullanım: 429 ve veri notu

HTTP 429, ücretsiz kullanım sınırlarından birine ulaşıldığını bildirir; bu sınır günlük ya da dakika başına olabilir ve yanıt Retry-After başlığını taşır. Başlıktaki süre kadar bekleyip yeniden deneyin. Kota dolduğunda akışınızın tamamen durmasını istemiyorsanız 429 aldığınız isteği kuyruğa alın ya da aynı istek gövdesini görsel girdi kabul eden ücretli bir modele gönderin; istek biçimi değişmez, yalnızca model kimliği değişir. Günlük kotayı nasıl yöneteceğiniz, bu satır için yazdığımız günlük kota yazısında ayrıntılı anlatılır.

Model kartındaki veri notuna göre istemler ve tamamlamalar sağlayıcı tarafından günlüğe kaydedilebilir ve modeli geliştirmek için kullanılabilir. Gönderdiğiniz görseller de istemin parçasıdır. Kişisel veri, kimlik belgesi ya da müşteri sırrı içeren görselleri bu satıra göndermeyin; gerekiyorsa önce maskeleyin ya da veri notu işinize uyan başka bir model seçin.

Başlamak: hesap, anahtar ve ilk istek

Adım 1: llmtr.com'da bir hesap oluşturun. Adım 2: Dashboard > API Anahtarları altında bir anahtar oluşturun; ham anahtar yalnızca bir kez gösterilir, onu LLMTR_API_KEY ortam değişkeninde saklayın. Adım 3: yukarıdaki örneği kendi görselinizle çalıştırın; model olarak qwen/qwen3.8-27b-free, base_url olarak https://llmtr.com/v1 kullanın.

Aynı anahtar katalogdaki diğer modellerde de çalışır. İleride görsel girdi kabul eden ücretli bir modele geçmek isterseniz Dashboard > Faturalandırma'dan bakiye yükleyin ve yalnızca model kimliğini değiştirin; istek gövdesi aynı kalır.

Ücretsiz Qwen3.8 27B'ye görsel gönderme

Bir API anahtarı oluşturun, görseli base64 data URL'ye çevirin ve qwen/qwen3.8-27b-free ile https://llmtr.com/v1 adresine gönderin.

1. API anahtarı. llmtr.com'da hesap açın, Dashboard > API Anahtarları altında bir anahtar oluşturun ve LLMTR_API_KEY ortam değişkeninde saklayın.
2. Görseli hazırlama. Görsel dosyasını base64'e çevirin ve data:image/png;base64, gibi MIME türünü taşıyan bir data URL oluşturun.
3. İstek. base_url değerini https://llmtr.com/v1 yapın ve model olarak qwen/qwen3.8-27b-free ile text ve image_url parçalarını içeren mesajı gönderin.

Sık sorulan sorular

Ücretsiz Qwen3.8 27B görsel kabul ediyor mu?

Evet, model kartı bu satır için görsel girdiyi listeler. Görseli /v1/chat/completions isteğinde image_url parçası olarak, örneğin base64 data URL biçiminde gönderin. Video ve ses girdisi bu satırda açık değildir; video_url ve input_audio parçaları 400 döner.

qwen/qwen3.8-27b-free gerçekten ücretsiz mi?

Evet. 1 milyon token başına girdi ve çıktı fiyatı 0 $'dır ve satır günlük kullanım kotasıyla sunulur. Bir sınıra ulaşıldığında HTTP 429 döner; Retry-After başlığı ne zaman yeniden deneyebileceğinizi söyler.

Gönderdiğim görseller nasıl kullanılabilir?

Model kartındaki veri notuna göre istemler ve tamamlamalar sağlayıcı tarafından günlüğe kaydedilebilir ve modeli geliştirmek için kullanılabilir; görseller de istemin parçasıdır. Hassas içerik taşıyan görselleri bu satıra göndermeyin.

İlgili yazılar

• Ücretsiz Qwen3.8 27B ile JSON çıktı: json_object rehberi
• Ekim 2026'da LLMTR'ye eklenen modeller: tablo ve rehber
• qwen3.6-27b-free emekli oldu: qwen3.8-27b-free'de günlük kota yönetimi

• Qwen3.8 27B (ücretsiz) model sayfası
• Görsel girdi dokümantasyonu
• Chat Completions dokümantasyonu
• Hata kodları