Ücretsiz görsel API
Görsel API, bir LLM'in görselleri okumasını sağlar. Bir fotoğrafı tarif etmesini, bir fişi okumasını veya bir grafiği açıklamasını isteyebilirsiniz. FreeLLMAPI kataloğunda görsel kabul eden 78 ücretsiz model teklifi vardır. Görselleri standart OpenAI biçiminde gönderirsiniz ve yönlendirici sizin için bir görsel modeli seçer. Bu rehber modelleri, her sağlayıcının boyut limitlerini ve çalışan kodu gösterir.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Görsel girdi nasıl çalışır
Görselleri messages dizisinde image_url içerik blokları olarak gönderin. URL, base64 baytlı bir data: URL'si veya bir http(s) URL'si olabilir. /v1/chat/completions kullanın. /v1/responses uç noktası henüz görsel kabul etmez.
- Otomatik yönlendirme: bir istek görsel içerdiğinde yönlendirici yalnızca görsel modellerini kullanır. O istek için yalnızca metin kabul eden modelleri yok sayar.
- Otomatik geçiş: bir görsel sağlayıcısı limitine ulaştığında yönlendirici zincirinizdeki sonraki görsel modelini dener.
- Açık hata: etkin bir görsel modeli yoksa
code: "no_vision_model"ile 422 hatası alırsınız. Görsel hiçbir zaman sessizce atılmaz.
Bugün ücretsiz görsel modelleri
Tablo, bugün katalogda görsel girdisi olan en güçlü ücretsiz modelleri gösterir. Veriler canlı katalogdan gelir. Bir satır, aynı modeli sunan birden çok sağlayıcıyı listeleyebilir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 Flash | UnoRouter | 1M | 1 istek/dk 1 req/min per model | Evet | Evet |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| Qwen3.8 27B | ElectronHub, Groq | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Evet | Evet |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Moondream 3.1 9B A2B | Cloudflare Workers AI, Moondream | 33K | ~10-20M | Hayır | Evet |
| Moondream 3 Preview | Moondream | - | $5/month shared workspace usage credits | Hayır | Evet |
67 eşleşen ücretsiz modelden 15 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Gemini modelleri en geniş bağlamı verir ve çok sayıda görseli kabul eder. Groq ve Cloudflare üzerindeki Qwen 3.8 27B, Google dışında hızlı bir seçimdir. Moondream görsel işleri için yapılmıştır, ancak çıktısı 4.096 jetonla sınırlıdır.
1. adım: FreeLLMAPI'yi kurun ve anahtarları ekleyin
FreeLLMAPI açık kaynaklıdır. Docker içinde bilgisayarınızda çalışır. Sağlayıcı anahtarlarınız bilgisayarınızda kalır.
Kurun (macOS veya Linux)
curl -fsSL https://freellmapi.co/install.sh | bashPanoyu http://localhost:3001 adresinde açın. Keys sayfasına bir Google AI Studio anahtarı ve bir anahtar daha ekleyin. Fallback Chain sayfasında görsel modellerinin bir Vision rozeti vardır. En az birinin etkin olduğundan emin olun. Birleşik anahtarınızı Keys sayfasından kopyalayın.
2. adım: Bir görsel gönderin
curl: URL'deki görsel
curl http://localhost:3001/v1/chat/completions \
-H "Authorization: Bearer <unified-key>" \
-H "Content-Type: application/json" \
-d '{
"model": "auto",
"messages": [{
"role": "user",
"content": [
{"type": "text", "text": "Describe this image in two sentences."},
{"type": "image_url", "image_url": {"url": "https://upload.wikimedia.org/wikipedia/commons/4/47/PNG_transparency_demonstration_1.png"}}
]
}]
}'Python: base64 olarak yerel dosya
import base64
from openai import OpenAI
client = OpenAI(base_url="http://localhost:3001/v1", api_key="<unified-key>")
with open("receipt.jpg", "rb") as fh:
b64 = base64.b64encode(fh.read()).decode()
resp = client.chat.completions.with_raw_response.create(
model="auto", # the router selects a vision model
messages=[{
"role": "user",
"content": [
{"type": "text", "text": "List each item and price on this receipt as JSON."},
{"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{b64}"}},
],
}],
)
print("Routed via:", resp.headers.get("x-routed-via"))
print(resp.parse().choices[0].message.content)Veri URL'sinde doğru bir MIME türü kullanın, örneğin image/png veya image/jpeg. Birden fazla görsel göndermek için aynı iletiye daha fazla image_url bloğu ekleyin.
Sağlayıcıya göre görsel limitleri
| Sağlayıcı | Limit (resmi) | Ne yapmalı |
|---|---|---|
| Google Gemini | Satır içi görsellerle toplam istek boyutu: 20 MB. Biçimler: PNG, JPEG, WEBP, HEIC, HEIF | Büyük fotoğrafları göndermeden önce küçültün |
| Google Gemini | 384x384 piksele kadar bir görsel 258 jeton tutar. Daha büyük görseller, her biri 258 jeton olan 768x768 karolara bölünür | 960x540 bir görsel 6 karo kullanır, yaklaşık 1.548 jeton |
| Groq (Qwen 3.8 27B) | Her istek için en fazla 3 görsel. Görsel URL'si olan bir istek için en fazla 20 MB | Groq modellerine en fazla 3 görsel gönderin |
| Moondream | Yalnızca base64 veri URL'leri. Uzak görsel URL'leri desteklenmez | Bağlantı değil, görsel baytlarını gönderin |
Görsel jetonları, ücretsiz katmanın dakikadaki jeton limitine dahil olur. Beş büyük görseli olan bir istek, küçük bir sağlayıcının limitinden büyük olabilir. İnce ayrıntıya ihtiyacınız yoksa görselleri küçültün, örneğin uzun kenarı 1024 piksel yapın.
Görsel işleri için çalışan istemler
- Her istek için bir görev: görsel hakkında tek ve net bir soru sorun. Tek istemde birden çok soru daha kısa ve daha az kesin yanıtlar verir.
- Yapılandırılmış çıktı: fişler ve formlar için istediğiniz alanları adlandırın, örneğin
item,pricevetotal. Yalnızca JSON isteyin. - Okunamayan değerler: modele bir değeri okuyamadığında
nullyazmasını söyleyin. Böylece tahmin yürütmez. - Önce kırpın: görseli yalnızca ihtiyacınız olan kısma kırpın. Daha küçük bir görsel daha az jeton kullanır ve daha iyi ayrıntı verir.
- Kararlı yanıtlar: çıkarım görevleri için
temperaturedeğerini 0 yapın. - Sayıları kontrol edin: toplamları ve tarihleri görselle karşılaştırın. Görsel modeller küçük metni ve benzer rakamları yanlış okuyabilir.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
Hata 422 no_vision_model | Zincirinizde etkin bir görsel modeli yok | Fallback Chain sayfasında Vision rozetli bir modeli etkinleştirin |
| Model bir görseli göremediğini söylüyor | İstek /v1/responses adresine gitti | /v1/chat/completions kullanın |
| Uzak bir URL'de hata 400 | Sağlayıcı URL'yi indiremiyor | Görseli base64 veri URL'si olarak gönderin |
| Büyük dosyalarda hata 413 veya 400 | Görsel veya istek çok büyük | Görseli küçültün veya daha az görsel gönderin |
| Görsel isteklerinde hata 429 | Görsel jetonları dakikadaki jeton limitini kullandı | Görselleri küçültün veya daha fazla görsel sağlayıcısından anahtar ekleyin |
Sık sorulan sorular
Ücretsiz bir görsel API var mı?
Evet. Google AI Studio, Groq, Cloudflare, NVIDIA, OpenRouter ve diğer sağlayıcılar görsel girdili ücretsiz modeller sunar. FreeLLMAPI, tek bir OpenAI uyumlu anahtar arkasında 78 ücretsiz görsel model teklifi sunar.
Ücretsiz bir LLM API'ye nasıl görsel gönderirim?
Kullanıcı iletisine bir image_url içerik bloğu ekleyin. Base64 veri URL'si veya https URL'si kullanın ve /v1/chat/completions adresine gönderin.
Bir görsel kaç jeton kullanır?
Gemini'de 384x384 piksel veya daha küçük bir görsel 258 jeton kullanır. Daha büyük bir görsel 768x768 karolara bölünür ve her karo 258 jeton kullanır.
Tek bir istekte birden çok görsel gönderebilir miyim?
Evet. İletiye daha fazla image_url bloğu ekleyin. Bazı sağlayıcılar sayıyı sınırlar. Örneğin Groq, Qwen 3.8 27B üzerinde her istek için 3 görsele izin verir.
Belge okumak için en iyi ücretsiz görsel model hangisi?
Fişler, grafikler ve taranmış sayfalar için bir Gemini modeli kullanın. Geniş bir bağlam penceresine sahiptir ve çok sayıda görseli kabul eder. Görsel modeller küçük metni yanlış okuyabileceği için rakamları görselle karşılaştırın.
İlgili rehberler
- Ücretsiz görüntü üretme API'si
- free gemini api
- free qwen api
- free gemma api
- Fonksiyon çağrısı destekli ücretsiz LLM API
Kaynaklar
- FreeLLMAPI docs: Vision and image input (20 November 2026 tarihinde kontrol edildi)
- Google AI Studio docs: Image understanding (20 November 2026 tarihinde kontrol edildi)
- Groq docs: Vision (20 November 2026 tarihinde kontrol edildi)
- Moondream OpenAI-compatible API docs (20 November 2026 tarihinde kontrol edildi)