Kısa cevap: ERNIE 5.5 Flash'ı OpenRouter'ın baidu/ernie-5.5-flash-preview:free endpoint'i üzerinden OpenCode ve Claude Code'da ücretsiz çalıştırabilirsiniz. OpenCode'da OpenRouter'a bağlanın ve "model": "openrouter/baidu/ernie-5.5-flash-preview:free" değerini ayarlayın. Claude Code'da ANTHROPIC_BASE_URL değişkenini OpenRouter'a yönlendirin ve ERNIE slug'ını model olarak sabitleyin. Token başına maliyeti $0'dır, ancak kredi satın almadıysanız günde 50 istek alırsınız.
Bu günlük sınır, kodlama ajanları (agent) için asıl önemli olan noktadır. Bir ajan görev başına tek istek yapmaz; her adım için bir istek yapar. Bu rehber her iki ajanı da kurulumunu gösterir, ücretsiz bütçeye sığan bir kodlama görevi sunar ve ücretsiz yolun nerede tıkandığını anlatır.
Aşağıdaki tüm sınırlar 12 Kasım 2026 tarihinde OpenRouter'ın resmi sayfalarından kontrol edilmiştir.
ERNIE 5.5 Flash Preview nedir?
ERNIE 5.5 Flash Preview, Baidu'nun 10 Kasım 2026'da yayımladığı sohbet ve ajan modelidir. Toplam 280 milyar parametreye sahip, token başına 14 milyar aktif parametreli ve 1.024.000 token'lık bağlam penceresine sahip seyrek bir mixture-of-experts modelidir. Baidu bu modeli kodlama, ajan tabanlı işler ve derin araştırma için konumlandırıyor; OpenRouter ise akıl yürütme (reasoning) özelliği açık ve araç çağırma (tool calling) destekli olarak listeliyor.
Hugging Face'te yalnızca ön eğitim için kullanılan bir ERNIE 5.5 Flash Base de var, ancak o modeli kendiniz ince ayar yapar veya kendiniz sunarsınız. Kodlama ajanınızın konuştuğu model Preview'dır. Modelin tam dökümü için what is ERNIE 5.5 Flash yazısını okuyun. Bir önceki nesilden geliyorsanız, ERNIE 5.1 genel bakışı nelerin değiştiğini ele alıyor.
OpenRouter'da ERNIE 5.5 Flash ücretsiz sınırları
OpenRouter'ın model sayfası, :free varyantını $0 girdi ve $0 çıktı fiyatıyla, tek bir sağlayıcı olan Baidu Qianfan üzerinden sunulacak şekilde gösteriyor. Hız sınırları OpenRouter'ın sınır dokümantasyonundan geliyor ve :free ile biten tüm model kimlikleri için geçerli.
| Öğe | Değer (2026-11-12 tarihinde kontrol edildi) |
|---|---|
| Model kimliği | baidu/ernie-5.5-flash-preview:free |
| Fiyat | $0 girdi, $0 çıktı |
| Bağlam penceresi | 1.024.000 token |
| Dakikadaki istek sayısı | 20 |
| Günlük istek sayısı, toplamda 10 krediden az satın alınmışsa | 50 |
| Günlük istek sayısı, toplamda 10+ kredi satın alınmışsa | 1.000 |
| Arkasındaki sağlayıcılar | 1 (Baidu Qianfan) |
Ajanlar için iki detay önemli. OpenRouter'ın fiyatlandırma sayfası, başarısız denemelerin de günlük sınıra dahil olduğunu söylüyor. Ve negatif bir kredi bakiyesi, bakiye tamamlandıncaya kadar ücretsiz modelleri 402 hatasıyla engelliyor.
Günde 1.000 isteklik kademe, harcadığınız kredilere değil, satın aldığınız kredilere bağlıdır.
OpenCode'da ERNIE 5.5 Flash kurulumu
OpenCode, OpenRouter'ı yerel olarak destekler, bu yüzden bu iki kurulumdan kısa olanıdır. Bir OpenRouter hesabına ve OpenRouter panonuzdan alınmış bir API anahtarına ihtiyacınız var.
- OpenCode'u kurun veya güncelleyin, ardından proje klasörünüzde başlatın:
cd your-project
opencode
- OpenRouter'a bağlanın. OpenCode içinde
/connectkomutunu çalıştırın, OpenRouter'ı seçin ve anahtarınızı yapıştırın. Ayrıca başlatmadan önce dışa aktarabilirsiniz:
export OPENROUTER_API_KEY="sk-or-v1-..."
- Modeli proje kökündeki
opencode.jsondosyasında sabitleyin. OpenCode'un sağlayıcı dokümantasyonu,openrouter/önekinden sonra tam OpenRouter model kimliğinin kullanılmasını söylüyor:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
- Seçimi
/modelsile doğrulayın. ERNIE listede görünmüyorsa, yapılandırma değeri yine de geçerlidir; o yüzden:freedahil slug'ın yazımını kontrol edin.
Artık her istem (prompt), OpenRouter üzerinden ERNIE 5.5 Flash Preview'a gidiyor. GLM-5.3-Flash OpenCode rehberimizi veya DeepSeek V4.1 Flash rehberini takip ettiyseniz, kalıp aynıdır: yalnızca slug değişir.
Claude Code'da ERNIE 5.5 Flash kurulumu
Claude Code, OpenRouter bir Anthropic uyumlu Messages endpoint'i sunduğu için OpenRouter ile konuşabilir. ERNIE model sayfası, POST https://openrouter.ai/api/v1/messages adresini bu model için desteklenen bir rota olarak listeliyor.
Önce destek düzeyi hakkında net olun. OpenRouter'ın Claude Code entegrasyon rehberi, OpenRouter ile Claude Code'un "yalnızca Anthropic birinci taraf sağlayıcıyla çalışacağının garanti edildiğini" ve Claude Code'un "diğer sağlayıcılarla doğru çalışmayabileceğini" söylüyor. ERNIE'yi burada çalıştırmak, belgelenmiş ayarlar üzerinden mümkündür, ancak bu garantili bir eşleşme değildir.
- Bağlantı değişkenlerini kabuk profilinizde, tam olarak OpenRouter'ın belgelediği şekilde ayarlayın:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly empty
- ERNIE'yi Claude Code'un kullandığı her model sınıfı için sabitleyin, böylece hiçbir adım sessizce ücretli bir Anthropic modeline düşmesin:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"
Kurulumun tek bir projeye kapsanmasını isterseniz, aynı anahtarları .claude/settings.json dosyasındaki env bloğuna koyabilirsiniz.
- Kabuğu yeniden yükleyin,
claudekomutunu başlatın ve/statuskomutunu çalıştırın.Auth token: ANTHROPIC_AUTH_TOKENveAnthropic base URL: https://openrouter.ai/apiifadelerini görmelisiniz.ANTHROPIC_API_KEYveya bir Claude hesabı girişi adı geçiyorsa, değişkenler oturuma ulaşmamıştır. - Sınıfların ERNIE'ye çözümlendiğini doğrulamak için
/modelkomutunu açın, ardından ilk isteminizden sonra OpenRouter etkinlik panonuzda model sütununu kontrol edin.
Genel Claude Code kurulumunu how to use Claude Code with OpenRouter yazısında daha ayrıntılı ele alıyoruz.
50 isteğe sığan gerçek bir kodlama görevi
Günde 50 istekle bir ajanın başıboş dolaşmasına izin veremezsiniz. "Tamamlanmış"ın neye benzediğini önceden bildiğiniz, sınırları belli bir görev verin. Küçük bir depoda (repo) iyi çalışan bir örnek:
In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.
Bu biçim neden ücretsiz kademede işe yarıyor:
- Dosyayı adıyla belirtiyor. Ajan, depo genelinde arama yapmayı atlar ve bu da birkaç istek tasarruf sağlar.
- Çözümü tanımlıyor. Durum kodu ve gövde istemde verildiği için geriye-ileriye iletişime gerek kalmaz.
- Kapsamı sınırlıyor. "Test çalıştırmasından sonra dur" ifadesi, ajanın sürekli cilalamasına izin vermek yerine döngüyü sonlandırır.
Böyle bir görev genellikle birkaç model çağrısı alır: rotayı oku, hata işleyiciyi oku, düzenle, testleri çalıştır, raporla. "Orders modülünü temizle" gibi belirsiz bir istem, tek bir şey üretilmeden günün kotasını tüketebilir.
1M bağlam penceresi, ERNIE'nin ajanlara uygun olmasının diğer nedenidir. Uzun bir yığın izini (stack trace) veya tüm bir OpenAPI dosyasını, birden fazla tura yaymak yerine tek bir isteme yapıştırabilirsiniz. Her istek önemli olduğunda, beş küçük istek yerine tek büyük istek kazanır.
ERNIE'nin API testlerinizi Apidog CLI ile çalıştırması
Ajan bir endpoint'i düzelttikten sonra, yalnızca bir birim testinin geçtiğini değil, API'nin hâlâ doğru davrandığına dair kanıt istersiniz. Apidog CLI, aynı ajanın ekibinizin Apidog'da zaten sakladığı test senaryolarını çalıştırmasını, hataları okumasını, kodu düzeltmesini ve senaryoları yeniden çalıştırmasını sağlar. Siz tek bir istem yazarsınız; ERNIE komutları çalıştırır.
CLI'yi kurun, giriş yapın ve ajan yeteneğini (skill) ekleyin:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick OpenCode or Claude Code when prompted
Ardından ajanınıza tek bir istem verin:
Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.
Ajan senaryoyu bulur, ayrıştırabileceği bir JSON raporuyla çalıştırır ve düzeltmeden sonra tekrar çalıştırır:
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
--upload-report bayrağı, çalıştırma özetini Apidog'a gönderir, böylece ekibiniz uygulama içinde açabilir. Ajanın karşılaştırma yapması gerekirse apidog test-report list --project <projectId> komutu geçmiş çalıştırmaları çeker.
Ancak bütçeyi hesaba katın. Her test çalıştırması, rapor okuması ve kod düzenlemesi bir ajan adımıdır; bu yüzden bir düzelt-ve-tekrar-çalıştır döngüsü kolayca 10 model isteği alabilir. Günde 50 isteklik kademede bu döngüyü bir-iki kez çalıştırın, tüm öğleden sonra boyunca değil. Apidog CLI in Claude Code rehberi ve apidog run komut referansı kalan bayrakları ele alıyor. Apidog'un Ücretsiz planı 4 kullanıcıya kadar ekipleri kapsar.
Ücretsiz yolun tıkandığı durumlar
Ücretsiz endpoint, tek bir sağlayıcının arkasındaki bir önizleme modelidir. Neler beklemeniz gerektiğini ve ne yapmanız gerektiğini burada bulabilirsiniz.
| Belirti | Olası neden | Çözüm |
|---|---|---|
Bir adım serisinden sonra 429 |
Dakikada 20 istek sınırı | Ajanı yavaşlatın veya bir dakika bekleyin |
Günün kalanında 429 |
50 günlük istek kullanıldı (başarısız denemeler de sayılır) | UTC sıfırlanmasını bekleyin veya günde 1.000 istek için 10 kredi satın alın |
Ücretsiz modelde 402 |
Negatif hesap bakiyesi | Bakiyeyi sıfırın üzerine çıkarmak için kredi ekleyin |
| Ajanın JSON çıktısında takılması | Yapılandırılmış çıktı hataları | Düz metin isteyin, kendiniz ayrıştırın |
| Claude Code özelliklerinin düzgün çalışmaması | Claude Code arkasında Anthropic olmayan bir model | ERNIE için OpenCode'u kullanın veya modeli geri değiştirin |
Yapılandırılmış çıktı satırı bir rakamı hak ediyor. 12 Kasım 2026'da OpenRouter'ın model sayfası, bu endpoint için %21,70'lik bir yapılandırılmış çıktı hata oranı ve %1,01'lik bir araç çağırma hata oranı gösteriyordu. Kodlama ajanlarının bağımlı olduğu araç çağırma sağlıklı görünüyor. Katı JSON şemaları ise öyle değil; bu yüzden ajan iş akışlarını araçlar ve düz metin üzerinde tutun.
Hız da öne çıkan rakamdan farklı. Baidu'nun açıklaması saniyede 200'den fazla token iddia ederken, OpenRouter o gün ücretsiz endpoint'te 79 token/saniyelik bir P50 ölçtü.
Son olarak, isminde "Preview" (Önizleme) olmasının bir nedeni var. Model, sınırları ve :free varyantı haber verilmeden değişebilir. Slug çözümlenmezse, yapılandırmanızda hata ayıklamadan önce OpenRouter sayfasını kontrol edin. Ücretli veya doğrudan erişim için ERNIE 5.5 Flash API rehberi Baidu Qianfan'ı ele alıyor.
SSS
ERNIE 5.5 Flash OpenCode'da gerçekten ücretsiz mi? Evet. baidu/ernie-5.5-flash-preview:free endpoint'i, OpenRouter'da girdi ve çıktı token başına $0 maliyete sahiptir. En az 10 OpenRouter kredisi satın almadıysanız dakikada 20 ve günde 50 istekle sınırlısınız.
Claude Code resmi olarak ERNIE 5.5 Flash'ı destekliyor mu? Resmi olarak hayır. OpenRouter, Claude Code'u diğer modellere nasıl yönlendireceğinizi belgeliyor, ancak kurulumun yalnızca Anthropic birinci taraf sağlayıcıyla garanti edildiğini söylüyor. Çalışır, ancak araçlarla ilgili pürüzlü noktalar bekleyin. ERNIE için daha güvenli seçim OpenCode'dur.
OpenRouter'da ERNIE 5.5 Flash için model kimliği nedir? Ücretsiz varyant için baidu/ernie-5.5-flash-preview:free'dir. OpenCode'da başına openrouter/ ekleyin. Claude Code'da ANTHROPIC_DEFAULT_*_MODEL değişkenlerinde olduğu gibi kullanın.
Günde 50 istekle kaç kodlama görevi tamamlayabilirim? Göreve bağlıdır. Sıkı kapsamlı bir düzeltme 5 ila 10 ajan adımı alabilir, bu yüzden birkaç görev sığar. Açık uçlu yeniden yapılandırmalar (refactor) tüm kotayı tek seferde tüketebilir. İstemlerinizde dosyaları adıyla belirtin ve "tamamlanmış"ı tanımlayın.
1M token'lık bağlamın tamamını ücretsiz kullanabilir miyim? OpenRouter, ücretsiz varyant için modelin tam penceresiyle aynı olan 1.024.000 token'lık bir bağlam penceresi listeliyor. Büyük istemler yine de her biri tek istek sayılır; bu da günlük sınıra karşı uzun bağlamlı istemleri verimli kılar.
OpenRouter olmadan ücretsiz bir seçenek var mı? ERNIE 5.5 Flash free rehberimiz tüm $0 yolları karşılaştırıyor. Baidu ayrıca ERNIE 5.5 Flash Base'i Hugging Face'te yayımladı; kendiniz sunabilirsiniz, running ERNIE 5.5 Flash locally with vLLM yazısında anlatıldığı gibi.