ERNIE 5.1 API Nasıl Kullanılır?

ERNIE 5.1 9 Mayıs 2026'da yayınlandı ve bir hafta içinde Qianfan API'si kullanıma açıldı. Modeli kendi kodunuzdan çağırmak, araç çağrılarını onun üzerinden yönlendirmek veya Apidog ile bir ajan döngüsüne bağlamak isterseniz, bu rehber tüm adımları (hesap, anahtar, istek gövdesi, akış, araç kullanımı, hata yönetimi) anlatır.

Pratik olacağız. Sonunda çalışan curl, Python ve Node kod parçacıklarına, ayrıca Apidog'a ekleyebileceğiniz bir istek koleksiyonuna sahip olacaksınız.

ERNIE 5.1 lansman analizini henüz okumadıysanız, önce ona bir göz atın; DeepSeek V4 ve Kimi K2.6 ile karşılaştırmalı performansları ve ödünleşimleri ele alır. Bu yazı, uygulamanıza eşlik edecektir.

Adım 1: Bir Qianfan API anahtarı alın

ERNIE 5.1, Baidu Akıllı Bulut'un Qianfan platformu üzerinden sunulmaktadır. Ayrı bir "ERNIE API" bulunmamaktadır; her şey Qianfan üzerinden yönlendirilir.

cloud.baidu.com adresine gidin ve bir Baidu Akıllı Bulut hesabı oluşturun veya oturum açın. Uluslararası geliştiriciler e-posta ile kaydolabilir; bazı kurumsal özellikler hala anakara telefon numarası gerektirmektedir.
Qianfan konsolunu console.bce.baidu.com/qianfan adresinde açın.
API Anahtar Yönetimi (API Key Yönetimi) altında, API Anahtarı Oluştur'a tıklayın. Çalışma alanını seçin ve sohbet tamamlama hizmetine erişim izni verin.
Anahtarı kopyalayın. Şuna benzer: bce-v3/ALTAK-xxxx/xxxx. Kaynak kodunuzda değil, bir ortam değişkeninde saklayın.

export QIANFAN_API_KEY="bce-v3/ALTAK-xxxx/xxxx"

Önceden bilmeniz gereken iki şey var. Birincisi, yeni v2 uç noktası tek bir Bearer token kullanır; eski v1 OAuth access_token akışı kullanımdan kaldırılıyor ve yeni kodunuzu buna göre oluşturmamanız gerekir. İkincisi, ERNIE 5.1 ilk günden itibaren ücretli bir modeldir. İlk isteğinizden önce küçük bir bakiye yükleyin (¥10 test etmek için yeterlidir).

Adım 2: OpenAI uyumlu uç noktasına curl ile istek gönderin

Qianfan, OpenAI uyumlu bir sohbet tamamlama uç noktası sunar, bu nedenle yığınınızdaki OpenAI formatını zaten anlayan her şey, temel URL değişikliği ve model kimliği değişikliği ile çalışacaktır.

Temel URL: https://qianfan.baidubce.com/v2 Model Kimliği: ernie-5.1 (ayrıca: erken erişim özellikleri için ernie-5.1-preview)

Minimum uygulanabilir istek:

curl https://qianfan.baidubce.com/v2/chat/completions \
  -H "Authorization: Bearer $QIANFAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ernie-5.1",
    "messages": [
      {"role": "system", "content": "You are a senior API designer."},
      {"role": "user", "content": "Sketch a REST schema for a GitHub-style PR review API. Be concise."}
    ],
    "temperature": 0.3
  }'

Standart OpenAI formatında bir yanıt alırsınız:

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "created": 1746780000,
  "model": "ernie-5.1",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 318,
    "total_tokens": 360
  }
}

Eğer 401 Unauthorized hatası görürseniz, anahtarınız yanlış veya süresi dolmuştur. Eğer 403 hatası görürseniz, anahtar geçerlidir ancak model bu çalışma alanında etkin değildir; konsola geri dönün ve ERNIE 5.1'i çalışma alanının izin verilen modellerine ekleyin.

Adım 3: ERNIE 5.1'i Python'dan çağırın

Uç nokta OpenAI uyumlu olduğu için, resmi openai Python SDK'sı olduğu gibi çalışır. Onu Qianfan'a yönlendirin.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["QIANFAN_API_KEY"],
    base_url="https://qianfan.baidubce.com/v2",
)

response = client.chat.completions.create(
    model="ernie-5.1",
    messages=[
        {"role": "system", "content": "You explain APIs in plain English."},
        {"role": "user", "content": "Why would I use server-sent events over WebSockets for a chat UI?"},
    ],
    temperature=0.4,
)

print(response.choices[0].message.content)
print(f"\nTokens used: {response.usage.total_tokens}")

Kod tabanınızda OpenAI SDK'sı etrafında sarmalayıcılarınız varsa, A/B testi için ERNIE 5.1'i değiştirmek tek satırlık bir değişikliktir. Aynı numara DeepSeek API'si ve çoğu diğer Çinli model sağlayıcıları için de geçerlidir.

Adım 4: Sohbet tarzı kullanıcı arayüzleri için token akışı

Kullanıcıya yönelik herhangi bir sohbet için akış istersiniz. stream: true ayarlayın ve sunucu tarafından gönderilen olayları tüketin.

stream = client.chat.completions.create(
    model="ernie-5.1",
    messages=[{"role": "user", "content": "Write a haiku about API versioning."}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Hata ayıklama için Curl karşılığı:

curl https://qianfan.baidubce.com/v2/chat/completions \
  -H "Authorization: Bearer $QIANFAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ernie-5.1",
    "stream": true,
    "messages": [{"role": "user", "content": "Stream a 3-sentence joke."}]
  }' \
  --no-buffer

Akış formatı OpenAI'ninkiyle aynıdır: data: {...} satırları data: [DONE] ile sonlandırılır.

Adım 5: ERNIE 5.1'i araçlarla kullanma (ajanik kısım)

ERNIE 5.1'in lansman başlığını hak ettiği yer burasıdır. Model, τ³-bench ve SpreadsheetBench-Verified'da DeepSeek-V4-Pro'nun üzerinde puan aldı, bu da araç çağırmanın sadece demolarda değil, üretimde de çalıştığı anlamına gelir.

OpenAI fonksiyon çağrısıyla aynı şema:

tools = [
    {
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Get current weather for a city.",
            "parameters": {
                "type": "object",
                "properties": {
                    "city": {"type": "string", "description": "City name, e.g. Singapore"},
                    "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
                },
                "required": ["city"],
            },
        },
    }
]

response = client.chat.completions.create(
    model="ernie-5.1",
    messages=[{"role": "user", "content": "What's the weather in Tokyo right now?"}],
    tools=tools,
    tool_choice="auto",
)

tool_calls = response.choices[0].message.tool_calls
if tool_calls:
    call = tool_calls[0]
    print(f"Model wants to call: {call.function.name}({call.function.arguments})")

Kodunuz gerçek aracı çalıştırdıktan sonra, sonucu bir tool rol mesajı olarak ekleyin ve tekrar çağrı yapın. Döngü, finish_reason == "stop" olduğunda ve tool_calls boş olduğunda sona erer.

Bir uyarı: ERNIE 5.1 bazen araç argümanlarını temiz bir JSON dizesi yerine kod bloğu içinde dizeleştirilmiş bir JSON olarak döndürür. json.loads()'u try/except içine alarak savunmacı bir şekilde ayrıştırın ve eğer başarısız olursa, tekrar denemeden önce ```json bloklarını kaldırın.

Adım 6: ERNIE 5.1'i Node.js'ten çağırın

openai v5+ kullanan herhangi bir Node projesi için doğrudan eklenebilir:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.QIANFAN_API_KEY,
  baseURL: "https://qianfan.baidubce.com/v2",
});

const completion = await client.chat.completions.create({
  model: "ernie-5.1",
  messages: [
    { role: "user", content: "Return a JSON object with 3 API design tips." },
  ],
  response_format: { type: "json_object" },
});

console.log(completion.choices[0].message.content);

response_format: { type: "json_object" } çalışır ve güvenilirdir. Kesin JSON şemaları (json_schema) Qianfan üzerinde hala kullanıma sunulmaktadır; kısıtlamaya güvenmek yerine yanıt şeklini kodda doğrulayın.

Adım 7: Apidog ile test edin ve karşılaştırın

ERNIE 5.1, DeepSeek V4 ve Kimi K2.6 arasında karar veriyorsanız, bunu terminalden yapmayın. Her sağlayıcı için bir klasör, aynı istek gövdeleri ve her API anahtarı için kaydedilmiş ortamlar içeren tek bir çalışma alanı oluşturmak için Apidog'u kullanın.

60 saniyelik kurulum:

Apidog'u açın ve "LLM bake-off" adında yeni bir proje oluşturun.

QIANFAN_API_KEY, DEEPSEEK_API_KEY, MOONSHOT_API_KEY değişkenleri ile bir ortam ekleyin.

Her sağlayıcının temel URL'sine işaret eden ve model değerleri sırasıyla ernie-5.1, deepseek-chat ve kimi-k2-6 olarak ayarlanmış üç istek oluşturun.

Her üçüne de aynı messages dizisini sabitleyin. Bunları paralel olarak çalıştırmak ve çıktıları karşılaştırmak için Apidog’un "Çalıştır" özelliğini kullanın.

Ücretsiz katman bunu rahatça halleder. Apidog, her ortam için istek geçmişini kaydeder, böylece gelecek hafta geri dönüp yeni bir model sürümüne karşı aynı değerlendirmeyi yeniden çalıştırabilirsiniz. Bir tmux penceresinde curl'ü sürekli izlemekten çok daha iyidir.

Çoklu sağlayıcı testi hakkında daha fazla bilgi için, Yerel LLM'leri API olarak test edin ve GLM 5.1 API rehberimize bakın.

Fiyatlandırma, oran sınırlamaları ve kotalar

ERNIE 5.1 için genel Qianfan fiyatlandırması yayın gönderisinde yoktu; dahili olarak rakamları belirtmeden önce canlı konsol fiyat kartını kontrol edin. Siz beklerken üç pratik ipucu:

Varsayılan oran sınırlamaları çalışma alanı kapsamındadır. Yeni hesaplar düşük bir QPS limiti ile başlar. Testleri bitirdikten sonra konsoldan yükseltin.
Token kullanımı yanıtta görünür. usage alanı, her çağrı için prompt_tokens, completion_tokens ve total_tokens verir. Bunları her istek için günlüğe kaydedin; maliyet muhasebesi için yalnızca kontrol paneline güvenmeyin.
Önbellekleme otomatik değildir. Anthropic'in aksine, Qianfan şu anda ERNIE 5.1 için bir istem önbellekleme ilkelini sunmamaktadır. Eğer 2.000 tokenlik bir sistem isteminiz varsa, her çağrıda bunun için ödeme yaparsınız. Buna göre mimarinizi tasarlayın.

Sizi kurtaracak hata yönetimi

Pratikte karşılaşacağınız hatalar, yaklaşık sıklık sırasına göre:

Durum	Anlamı	Çözüm
401	Taşıyıcı (Bearer) token yanlış veya süresi dolmuş	Konsoldan yeniden oluşturun
403	Model bu çalışma alanında etkin değil	ERNIE 5.1'i konsoldan ekleyin
429	Oran limiti aşıldı	Gecikmeli geri çekilme + jitter ile tekrar deneyin
400 (`geçersiz mesajlar`)	Yanlış mesaj-rol sıralaması	Kullanıcı/asistan değişimini sağlayın
500/502	Qianfan tarafında anlık sorun	Bir kez tekrar deneyin; devam ederse, durum sayfasını kontrol edin

Her çağrıyı, 3 deneme ile sınırlı, üstel geri çekilme ile tekrar deneme döngüsüne sarın. Üretim için, yanıt başlıklarından request_id'yi günlüğe kaydedin; Baidu desteğinin durumunuzu hata ayıklamak için buna ihtiyacı olacaktır.

Minimum üretim odaklı sarmalayıcı

ERNIE 5.1'i bugün gerçek bir uygulamaya dahil etmek isterseniz, işte utandırmayacak en küçük sarmalayıcı:

import os, time, random, json
from openai import OpenAI, RateLimitError, APIError

client = OpenAI(
    api_key=os.environ["QIANFAN_API_KEY"],
    base_url="https://qianfan.baidubce.com/v2",
)

def chat(messages, *, model="ernie-5.1", temperature=0.3, max_retries=3):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model=model,
                messages=messages,
                temperature=temperature,
            )
        except RateLimitError:
            time.sleep((2 ** attempt) + random.random())
        except APIError as e:
            if e.status_code and e.status_code >= 500 and attempt < max_retries - 1:
                time.sleep(1 + attempt)
                continue
            raise
    raise RuntimeError("ERNIE 5.1 retries exhausted")

Bu, durumların %80'ini karşılar. Araç döngüleri ve akış için, bunun üzerine inşa edin.

Sıkça sorulan sorular

ERNIE 5.1 API'si ücretsiz mi? Hayır. Qianfan kullandıkça öde esasına göre çalışır. Kalıcı bir ücretsiz katman yoktur; yeni hesaplar bazen deneme kredileri alır. Ücretsiz denemeler için ernie.baidu.com sohbet arayüzünü kullanın veya ücretsiz LLM seçeneklerine göz atın.

ERNIE 5.1'i yerel olarak çalıştırabilir miyim? Hayır. Açık ağırlıklar mevcut değil. Eğer şirket içi kullanım zorunlu bir gereksinimse, bunun yerine DeepSeek V4'ü yerel olarak nasıl çalıştıracağınıza veya 2026'nın en iyi yerel LLM'lerine bakın.

OpenAI SDK'sı değişiklik yapmadan çalışır mı? Evet, base_url https://qianfan.baidubce.com/v2 olarak ve api_key Qianfan anahtarınıza ayarlandığında. model alanı OpenAI modelleri yerine Qianfan model kimliklerini alır. Fonksiyon çağırma, akış ve response_format: json_object hepsi çalışır. Kesin json_schema doğrulaması hala kullanıma sunulmaktadır.

ERNIE 5.1 Çince ve İngilizce istemleri nasıl ele alır? Her ikisi de birinci sınıf desteklenir. 1.223'lük Arena Arama puanı, karma dilli bir seçmen havuzundan geldi. Teknik İngilizce görevleri (kod, API tasarımı) için kapalı sınırlardaki modellerle rekabetçidir; Çince yaratıcı yazım için Çin modelleri arasında sınıfının en iyisidir.

Maksimum çıktı uzunluğu nedir? Resmi olarak yayınlanmadı. Pratikte, tek dönüşlü yanıtlar modelin tamamlanmasından önce yaklaşık 8 bin token ile sınırlıdır. Uzun biçimli üretim için, parçalara ayırın ve devam edin.

ERNIE 5.1 üzerinde bir ajan mı geliştiriyorsunuz? Apidog'u indirin ve OpenAI uyumlu istek koleksiyonunu kullanarak Qianfan uç noktasını diğer hizmetlerinizle birlikte sahte hale getirin, test edin ve belgeleyin.