ERNIE 5.5 Flash API'sini Qianfan ve OpenRouter ile Nasıl Kullanılır

ERNIE 5.5 Flash API iki yerde kullanıma açıldı: resmi olarak https://qianfan.baidubce.com/v2/chat/completions adresinden ernie-5.5-flash-preview modelini çağırdığınız Baidu Qianfan ve token başına 0 dolar olan baidu/ernie-5.5-flash-preview:free modelini sunduğu OpenRouter. İkisi de OpenAI Chat Completions formatını kullandığı için, temel URL'yi, anahtarı ve model adını değiştirerek resmi OpenAI SDK'yı her ikisine de yönlendirebilirsiniz.

Aşağıda: anahtarlar, curl, Python ve JavaScript ile ilk istekler, streaming, akıl yürütme (reasoning) tokenları, 1M bağlam penceresi ve hatalar yer alıyor. Tüm alanlar ve limitler, 12 Kasım 2026 tarihinde doğrulanmış resmi Qianfan ve OpenRouter sayfalarından alınmıştır.

Arka plan bilgisi için ERNIE 5.5 Flash nedir yazısını veya bir önceki nesil için ERNIE 5.1 API rehberini okuyabilirsiniz.

ERNIE 5.5 Flash API nedir?

ERNIE 5.5 Flash API, Baidu'nun ERNIE 5.5 Flash Preview için sunmuş olduğu barındırılan bir uç noktadır. Token başına 14B aktif parametreye sahip, toplam 280B parametreli, seyrek bir mixture-of-experts (uzman karışımı) modelidir ve 1M token bağlam penceresi sunar. Baidu, ERNIE 5.5 Flash Base üzerine inşa edilen ve eğitim sonrası işlemleri tamamlanmış ilk model olarak 11 Kasım 2026'da yayınladı ve Qianfan ile OpenRouter üzerinden sunuyor.

Baidu'nun yayın duyurusu, modeli kodlama, ajan tabanlı görevler, 3B modelleme, bilgi işi ve içerik üretimi için öneriyor. Modelin ara bir kontrol noktası (checkpoint) olduğunu belirtiyor, yani davranışının değişebileceğini beklemelisiniz, ayrıca ağırlıkların "yakında" Apache 2.0 altında açık kaynak olarak yayınlanacağı söyleniyor ancak bir tarih verilmemiş.

Qianfan mı OpenRouter mı: hangi uç noktayı kullanmalısınız?

Aşağıda, her iki platformun bugün yayınladığı bilgilere dayanarak iki yolun karşılaştırmasını bulabilirsiniz.

OpenRouter tek bir sağlayıcı olan Baidu Qianfan'ı listelediği için her iki yol da aynı arka uca bağlanır. Gerçek fark limitlerdedir: OpenRouter'ın ücretsiz katmanı prototip oluşturma ve değerlendirme için uygunken, Qianfan'ın varsayılan 300 RPM limiti üretim ortamları için uygundur. Ücretsiz ERNIE 5.5 Flash rehberi, 0 dolarlık yolları daha derinlemesine inceliyor.

ERNIE 5.5 Flash API anahtarını nasıl alırsınız?

Qianfan

1. Baidu AI Cloud hesabınızla Qianfan konsoluna giriş yapın.
2. Sistem yönetimi altında API Key (API Anahtarı) bölümünü açın ve bir anahtar oluşturun. Anahtar şu forma benzer: bce-v3/ALTAK-....
3. Anahtarı dışa aktarın: export QIANFAN_API_KEY="bce-v3/ALTAK-...".

Qianfan, çağrıların ücretini Baidu AI Cloud bakiyenizden düşer. Negatif bir bakiye 403 account_overdue hatası döndürür, bu yüzden yük testinden önce bakiyenizi doldurun.

OpenRouter

1. OpenRouter'da bir hesap ve bir anahtar oluşturun.
2. Anahtarı dışa aktarın: export OPENROUTER_API_KEY="sk-or-v1-...".
3. baidu/ernie-5.5-flash-preview:free model kimliğini kullanın.

İlk ERNIE 5.5 Flash isteğinizi gönderin

curl

Qianfan:

curl https://qianfan.baidubce.com/v2/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QIANFAN_API_KEY" \
  -d '{
    "model": "ernie-5.5-flash-preview",
    "messages": [
      {"role": "system", "content": "You are a concise senior engineer."},
      {"role": "user", "content": "Write a Python function that validates an ISO 8601 date."}
    ]
  }'

OpenRouter:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -d '{
    "model": "baidu/ernie-5.5-flash-preview:free",
    "messages": [
      {"role": "user", "content": "Write a Python function that validates an ISO 8601 date."}
    ]
  }'

Python

SDK'yı pip install openai ile kurun ve sağlayıcıya göre temel URL'yi değiştirin:

import os
from openai import OpenAI

PROVIDERS = {
    "qianfan": ("https://qianfan.baidubce.com/v2", "QIANFAN_API_KEY", "ernie-5.5-flash-preview"),
    "openrouter": ("https://openrouter.ai/api/v1", "OPENROUTER_API_KEY", "baidu/ernie-5.5-flash-preview:free"),
}

base_url, key_env, model = PROVIDERS["qianfan"]
client = OpenAI(base_url=base_url, api_key=os.environ[key_env])

resp = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
    max_completion_tokens=4096,
)
print(resp.choices[0].message.content)
print(resp.usage)

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "baidu/ernie-5.5-flash-preview:free",
  messages: [{ role: "user", content: "List three causes of HTTP 499 errors." }],
});
console.log(resp.choices[0].message.content);

ERNIE 5.5 Flash yanıtlarını nasıl akıtarsınız?

İsteğe "stream": true ekleyin ve her iki sağlayıcı da data: [DONE] ile sonlanan sunucudan gönderilen olayları (server-sent events) döndürür. Qianfan'da son parçada (chunk) token sayılarını almak için "stream_options": {"include_usage": true} ekleyin. Bu formatla yeni tanışıyorsanız, SSE akış rehberi kablo formatını açıklıyor.

stream = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Draft a README for a CLI tool."}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices:
        delta = chunk.choices[0].delta
        thinking = getattr(delta, "reasoning_content", None)
        if thinking:
            print(f"[thinking] {thinking}", end="", flush=True)
        if delta.content:
            print(delta.content, end="", flush=True)
    if chunk.usage:
        print("\n", chunk.usage)

Varsayılan olarak akışı kullanın: model cevaptan önce akıl yürütür, bu yüzden engelleyici (blocking) bir çağrı bir süreye kadar sessiz kalabilir.

Akıl yürütme tokenları her sağlayıcıda nasıl çalışır?

ERNIE 5.5 Flash Preview bir akıl yürütme modelidir ve iki platform bunu farklı şekillerde ortaya çıkarır.

Qianfan'da, derin düşünme belgeleri, thinking parametresi için ernie-5.5-flash-preview modelini "yalnızca etkinleştirilebilir, devre dışı bırakılamaz" olarak listeler ve varsayılan reasoning_effort değeri olan high ayarı "ayarlanamaz". Yani burada akıl yürütme işlemini kapatamaz veya azaltamazsınız. Düşünce zinciri, content alanından ayrı olarak reasoning_content alanında döner. Qianfan bunu max_completion_tokens içinde sayar, bu yüzden düşük bir üst sınır nihai cevabı yarıda kesebilir ve size finish_reason: "length" sonucu bırakabilir.

OpenRouter'da, akıl yürütmeyi reasoning nesnesi ile kontrol eder ve izi reasoning_details alanından okursunuz. İzi yanıttan gizlemek için:

{
  "model": "baidu/ernie-5.5-flash-preview:free",
  "reasoning": { "exclude": true },
  "messages": [{ "role": "user", "content": "Is 2^61 - 1 prime?" }]
}

Çok turlu sohbetlerde, OpenRouter modelin kaldığı yerden devam edebilmesi için asistan mesajıyla birlikte tüm reasoning_details alanını geri göndermenizi ister. Akıl yürütme token sayısı usage.completion_tokens_details.reasoning_tokens alanında görünür.

1M token bağlam penceresi için ipuçları

Bir milyon token, orta ölçekli bir kod tabanını barındırır. Dört alışkanlık uzun çağrıları öngörülebilir kılar:

1. Yalnızca isteklere değil, dakikadaki tokena göre bütçe planlayın. Qianfan'ın varsayılanı 3.000.000 TPM'dir, yani bir dakikada üç adet dolu 1M token istek tüm kotayı tüketir. Her yanıttaki X-Ratelimit-Remaining-Input-Tokens başlığını izleyin.
2. Sabit içeriği başa koyun. Sistem istemini ve referans dokümanları başta, değişen soruyu sondada tutun, böylece tekrarlayan önekler önbelleğe takılabilir. OpenRouter, bu model için 12 Kasım'da %90,83'lük bir önbellek isabet oranı gösterdi.
3. Akıl yürütme için alan bırakın. max_completion_tokens değerini hem düşünce hem de cevabı kapsayacak kadar yüksek ayarlayın.
4. Hız iddialarına güvenmeden önce ölçün. Baidu, modelin saniyede 200 token'dan fazla ürettiğini söylüyor. OpenRouter'ın ücretsiz uç noktasında, 12 Kasım'da P50 verim saniyede 79 token, P50 gecikme ise 2,53 saniyeydi.

Yapılandırılmış çıktılar için, üretime almaya karar vermeden önce sıkı testler yapın. OpenRouter, JSON şeması ile response_format kabul ediyor, ancak sayfası üç gün boyunca bu model için %21,70'lik bir yapılandırılmış çıktı hata oranı ve buna karşılık %1,01'lik bir araç çağırma hata oranı bildirdi. Her JSON yanıtını doğrulayın ve ayrıştırma hatalarında tekrar deneyin.

ERNIE 5.5 Flash API hataları ve hız limitleri

En sık göreceğiniz kodlar, Qianfan'ın hata kodu tablosundan ve OpenRouter'ın limitler sayfasından alınmıştır:

OpenRouter'da, GET https://openrouter.ai/api/v1/key çağrısı free_model_daily_requests.remaining değerini döndürür. 429 hatalarını üstel geri çekilme (exponential backoff) ve jitter ile tekrar deneyin; asla 400 veya 401 hatalarını tekrar denemeyin.

Kodlama ajanınızın her iki uç noktayı Apidog CLI ile test etmesine izin verin

Her iki sağlayıcı da yanıt verdikten sonra, doğru yanıt vermeye devam ettiklerinin kanıtını istersiniz: doğru durum, doğru form, kabul edilebilir gecikme. Bunu kodlama ajanınıza devredin. Apidog CLI, Claude Code, Codex, Cursor veya OpenCode'a uç noktayı içe aktarma, sağlayıcı başına bir ortam kaydetme ve her birine karşı bir test senaryosu çalıştırma komutlarını sağlar.

Bunu bir kez kurun:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Sonra ajanınıza tek bir istem verin:

Write an OpenAPI 3 file for POST /chat/completions that matches the ERNIE 5.5 Flash
request and response shape (model, messages, stream; choices[0].message.content, usage).
Import it into Apidog project <projectId>. Create two environments: "qianfan" with base
URL https://qianfan.baidubce.com/v2 and "openrouter" with https://openrouter.ai/api/v1,
each with a "model" variable. Build one test scenario that sends a short prompt and
asserts status 200, the response schema, and a response time under 30 seconds. Run it
against both environments, passing the API keys as environment variables, and summarize
any failures.

Ajan her şemayı kontrol eder, veri yüklerini doğrular ve şu komutları çalıştırır:

apidog import --project <projectId> --format openapi --file ./ernie-5-5-flash.openapi.yaml
apidog environment create qianfan --project <projectId> --base-url https://qianfan.baidubce.com/v2
apidog environment create openrouter --project <projectId> --base-url https://openrouter.ai/api/v1
apidog cli-schema get test-scenario-create
apidog test-scenario create --project <projectId> --name "ERNIE 5.5 Flash smoke" --folder-id <folderId> --priority <priority>
apidog test-scenario import-steps <scenarioId> --project <projectId> --source endpoint --ids <endpointId> --sync manual
apidog run -t <scenarioId> --project <projectId> -e <qianfanEnvId> --env-var "apiKey=$QIANFAN_API_KEY" -r cli,json
apidog run -t <scenarioId> --project <projectId> -e <openrouterEnvId> --env-var "apiKey=$OPENROUTER_API_KEY" -r cli,json

Anahtarları --env-var ile geçirmek, bunların kaydedilen projede saklanmasını önler ve tek bir senaryo size her iki yol için yan yana bir okuma sağlar. -r junit ile aynı apidog run komutu bir hattaya (pipeline) dahil edilebilir; Apidog CLI CI/CD rehberi kurulumu gösterir ve Claude Code'da Apidog CLI ajan tarafını kapsar. Apidog'un Ücretsiz planı 4 kullanıcıya kadar olanak tanır.

SSS

ERNIE 5.5 Flash API ücretsiz mi? OpenRouter'da evet: baidu/ernie-5.5-flash-preview:free token başına 0 $ ve limitleri dakikada 20 istek, günde 50 istek veya 10 $ değerinde kredi satın aldıktan sonra günde 1.000 istektir. Qianfan ise çağrıların ücretini Baidu AI Cloud bakiyenizden düşer.

ERNIE 5.5 Flash için model kimliği nedir? Qianfan'da ernie-5.5-flash-preview ve OpenRouter'da baidu/ernie-5.5-flash-preview:free model kimliklerini kullanın.

Qianfan'da düşünme özelliğini kapatabilir miyim? Hayır. Qianfan'ın belgeleri, bu model için düşünme özelliğinin yalnızca etkinleştirilebildiğini ve reasoning_effort değerinin high olarak kaldığını belirtir. Akıl yürütme izi için çıkış tokenlarını bütçe planlayın.

ERNIE 5.5 Flash API araç çağırmayı destekliyor mu? Evet. Qianfan, Fonksiyon Çağırma ve yapılandırılmış çıktıyı desteklenen özellikler olarak listelerken, OpenRouter tools, tool_choice ve response_format kabul ediyor. OpenRouter bu konuda yüksek bir hata oranı bildirdiği için yapılandırılmış çıktıları doğrulayın.

ERNIE 5.5 Flash'ı kendim çalıştırabilir miyim? Baidu, ERNIE 5.5 Flash Base modelini Hugging Face üzerinde yayınladı ve Preview ağırlıkları için Apache 2.0 altında söz verildi. ERNIE 5.5 Flash'ı vLLM ile yerel olarak çalıştırma yazısına bakın.

DeepSeek V4.1 Flash ile karşılaştırması nasıldır? ERNIE 5.5 Flash vs DeepSeek V4.1 Flash yazısına ve DeepSeek V4.1 Flash API rehberine göz atın.