Bölümler

API Dokümantasyonu

Mihfar Interface, OpenAI uyumlu bir API geçididir. Mevcut SDK'larınızla çalışır — sadece base URL'i değiştirin. Üstüne Mihfar Akıllı Modeller kazanırsınız.

Base URL: https://api.mihfar.com · Tüm fiyatlar Türk Lirası (₺) cinsindendir.

🚀 Hızlı Başlangıç

Hesap oluşturun → Kayıt
Dashboard'dan API Anahtarı oluşturun
Bakiye yükleyin (Shopier ile TL)
Aşağıdaki kodu çalıştırın:

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.mihfar.com/v1",
)

response = client.chat.completions.create(
    model="mihfar-auto",
    messages=[{"role": "user", "content": "Merhaba!"}],
)
print(response.choices[0].message.content)

🔐 Kimlik Doğrulama

Tüm isteklerde Authorization header'ı gereklidir:

Authorization: Bearer sk-your-api-key

API anahtarları Dashboard → API Anahtarları sayfasından oluşturulur.

💳 Bakiye & Fiyatlandırma

Platform TL (Türk Lirası) üzerinden çalışır.
Bakiye yüklemek için Dashboard → Bakiye → Shopier ile ödeme yapın.
Her API isteğinde harcanan TL bakiyenizden otomatik düşülür.
Bakiyeniz sıfırlandığında istekler 402 hatası verir.

Yeni üyelere hoş geldin bonusu tanımlanabilir. Kayıt olun ve hemen başlayın.

✦ Mihfar Akıllı Modeller

Mihfar, tek bir model ID ile birden fazla modeli yöneten sanal model katmanıdır. Gerçek modeli bilmenize gerek yoktur; Mihfar en uygun modele yönlendirir, biri çalışmazsa zincirdeki sonrakine geçer.

🤖 Mihfar Auto

mihfar-auto

Prompt analizi ile otomatik seçim.

⚡ Mihfar Fast

mihfar-fast

Hızlı yanıt, basit görevler.

🧠 Mihfar Smart

mihfar-smart

Kalite odaklı, karmaşık görevler.

💻 Mihfar Coder

mihfar-coder

Kod yazma ve debug.

👁️ Mihfar Vision

mihfar-vision

Görüntü ve belge analizi.

💡 Mihfar Reason

mihfar-reason

Matematik ve derin analiz.

Mihfar Auto Mantığı

Prompt içeriğiniz analiz edilir ve %25 indirimli fiyatla en uygun alt route'a yönlendirilir:

Görsel içerik → Vision
Kod anahtar kelimeleri (def, class, bug, import…) → Coder
Analiz/matematik (adım adım, ispat, hesapla…) → Reason
Kısa/basit soru → Fast
Diğer → Smart

GET /v1/models

GET/v1/models

Mihfar sanal modelleri ve sisteme kayıtlı tüm aktif modelleri döndürür.

{
  "object": "list",
  "data": [
    { "id": "mihfar-auto", "owned_by": "mihfar" },
    { "id": "gpt-4o",      "owned_by": "mihfar" }
  ]
}

POST /v1/chat/completions

POST/v1/chat/completions

Alan	Tür	Açıklama
model	string	Mihfar veya gerçek model ID
messages	array	Rol + içerik mesaj dizisi
stream	boolean	SSE akışı (varsayılan false)
temperature	float	0.0–2.0 yaratıcılık
max_tokens	integer	Maks. yanıt token

curl https://api.mihfar.com/v1/chat/completions \
  -H "Authorization: Bearer sk-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"mihfar-smart","messages":[{"role":"user","content":"Merhaba"}]}'

POST /v1/embeddings

POST/v1/embeddings

Metni vektör temsillerine dönüştürür. RAG ve semantik arama için.

{ "model": "nomic-embed-text", "input": "Makine öğrenmesi" }

🔧 Tool Calling

Modellerin harici fonksiyonları çağırmasını sağlar. Mihfar Smart ve Coder ile en iyi sonuç alınır.

{
  "model": "mihfar-smart",
  "messages": [{ "role": "user", "content": "Hava durumu?" }],
  "tools": [{ "type": "function", "function": {
    "name": "get_weather",
    "parameters": { "type": "object",
      "properties": { "city": { "type": "string" } } }
  }}],
  "tool_choice": "auto"
}

👁️ Vision (Görüntü)

mihfar-vision otomatik vision destekli modele yönlendirir. URL veya Base64 desteklenir.

{
  "model": "mihfar-vision",
  "messages": [{ "role": "user", "content": [
    { "type": "image_url", "image_url": { "url": "https://..." } },
    { "type": "text", "text": "Bu görselde ne var?" }
  ]}]
}

💬 Oturum Yönetimi

Mesaj geçmişini sunucuda saklayan oturum API'si.

POST/v1/sessions

GET/v1/sessions/{id}

POST/v1/sessions/{id}/chat

DELETE/v1/sessions/{id}

⚡ Streaming

"stream": true ile yanıt SSE formatında akar.

curl -N https://api.mihfar.com/v1/chat/completions \
  -H "Authorization: Bearer sk-key" \
  -d '{"model":"mihfar-auto","messages":[...],"stream":true}'

⏱ Rate Limiting

Her kullanıcı için dakika (RPM) ve saat (RPH) limiti uygulanır. Limitler response header'larında bildirilir.

Header	Açıklama
X-RateLimit-Limit-RPM	Dakikada maks. istek
X-RateLimit-Remaining-RPM	Bu dakikada kalan hak
Retry-After	Bekleme süresi (saniye)

Limit aşıldığında 429 Too Many Requests döner.

⚠️ Hata Kodları

Kod	Açıklama
400	Geçersiz parametre / model bulunamadı
401	Geçersiz veya eksik API anahtarı
402	Yetersiz bakiye
429	Rate limit aşıldı
503	Route zincirindeki modeller kullanılamıyor

❓ SSS

Mihfar modellerini mi yoksa gerçek modelleri mi kullanmalıyım?

Mihfar modellerini öneririz. Fallback zinciri ile yüksek erişilebilirlik sağlarlar ve model değişikliklerinde kod güncellemenize gerek kalmaz.

Fiyatlandırma nasıl çalışır?

Token bazlı, ₺/1M token cinsinden. Güncel liste için Fiyatlar sayfasına bakın. Mihfar Auto %25 indirim uygular.

Hangi gerçek modeller destekleniyor?

OpenAI, Anthropic Claude, Groq, Mistral ve yerel Ollama. Aktif liste için Modeller sayfasını ziyaret edin.