Geliştirici Dokümantasyonu

BİLGE V1 API, sıfırdan eğitilen Türkçe dil modeline ve 32K BPE tokenizer motoruna programatik olarak erişmenizi sağlar. OpenAI ve Anthropic standartlarına uyumlu RESTful mimari ile tasarlanmıştır.

Kimlik Doğrulama (Authentication)

Tüm API istekleri HTTP Authorization başlığı üzerinden Bearer token ile imzalanmalıdır. API anahtarlarınızı MLOps Yönetim Paneli üzerinden oluşturabilirsiniz.

Authorization: Bearer bilge_live_sk_948f20a17bc84e11a9

Verilen Türkçe istem veya mesaj geçmişi üzerinden BİLGE V1 modelinden çıkarım üretir.

İstek Parametreleri (Body)

cURL İstek Örneği

curl -X POST https://bilge.teymensel.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bilge-v1-350m",
    "messages": [
      {"role": "user", "content": "Türkiye'nin başkenti neresidir?"}
    ],
    "temperature": 0.7,
    "max_tokens": 128
  }'

Girdi metnini BİLGE 32K Türkçe BPE kelime dağarcığına göre alt kelimelere (tokens) ve token ID'lerine dönüştürür.

// Yanıt Örneği (JSON)
{
  "text": "Merhaba Bilge",
  "tokens": ["Merh", "##aba", "Bilg", "##e"],
  "token_ids": [1042, 4821, 9104, 204],
  "token_count": 4
}

Python SDK Kılavuzu

Resmî Python paketi ile tek satırda BİLGE V1 modelini yerel ortamınızda veya API üzerinden çalıştırabilirsiniz:

pip install bilge-ai

import bilge

client = bilge.Client(api_key="YOUR_API_KEY")

response = client.chat.completions.create(
    model="bilge-v1-350m",
    messages=[
        {"role": "user", "content": "Kısa bir Türkçe masal yaz."}
    ],
    temperature=0.7
)

print(response.choices[0].message.content)

Sıfırdan Model Eğitimi (0'dan Eğitim)

BİLGE V1 altyapısını kullanarak kendi özel dil modelinizi (LLM) sıfırdan pre-training (ön-eğitim) veya fine-tuning (ince ayar) yöntemiyle eğitebilirsiniz. Eğitim sürecine başlamak için aşağıdaki adımları sırasıyla takip edin.

{"text": "BİLGE, Türkçe odaklı olarak geliştirilen bir büyük dil modelidir..."}
{"text": "Yapay zeka modellerinin eğitimi, yüksek hesaplama gücü gerektirir..."}