Maximize AI API
Claude, GPT, Gemini ve ekonomik açık modellere TEK anahtarla erişim — token bazlı fiyatlandırmalı REST API. OpenAI uyumlu format; akıllı yönlendirme, sağlayıcı düşerse otomatik yedek ve önbellekle maliyet düşürme dahil.
Kimlik Doğrulama
Her istekte X-API-Key header'ı ile API key'inizi gönderin.
Modeller & Fiyatlar
Tüm modeller aynı endpoint üzerinden kullanılır. model parametresiyle seçim yapın.
/ 1M token
/ 1M token
/ 1M token
/ 1M token
🌐 OpenAI & Google
/ 1M token
/ 1M token
/ 1M token
💚 Ekonomi Modelleri
Açık ağırlıklı modeller — bütçe dostu, yüksek hacimli işler için. Claude'dan çok daha ucuz.
/ 1M token
/ 1M token
/ 1M token
Emekliye ayrılan model id'leri (gpt-4o, gemini-2.5-flash, llama-3.3-70b, claude-sonnet-4-6 vb.) çalışmaya devam eder — istek otomatik olarak halef modele yönlendirilir.
Chat Completions
İstek Parametreleri
| Parametre | Tip | Açıklama |
|---|---|---|
| messages* | array | Sohbet mesajları dizisi |
| model? | string | Model ID (varsayılan: claude-haiku-4-5) |
| max_tokens? | integer | Maksimum çıktı token (varsayılan: 512) |
| temperature? | float | Yaratıcılık 0-1 arası (varsayılan: 0.7). Claude 5 ailesi (Sonnet 5 / Opus 5 / Fable 5) bu parametreyi kabul etmez — gönderilirse yok sayılır. |
| stream? | boolean | Akış modu (varsayılan: false) |
Örnek İstek
Örnek Yanıt
Billing
Araçlar (Function Calling)
Kendi fonksiyonlarınızı tanımlayın — Claude hangisini ne zaman çağıracağına karar verir, siz kendi sisteminizde çalıştırıp sonucu geri gönderirsiniz. OpenAI tools formatıyla birebir uyumlu.
tool_calls) → 3) Fonksiyonu çalıştırıp sonucu tool rolüyle geri gönderin → 4) Claude nihai cevabı üretir.
Örnek (OpenAI SDK)
stream: true desteklenmez — tam tool_calls gerekir.
Webhooks
Dashboard'dan webhook URL'nizi kaydedin. Bakiye olaylarında sisteminize imzalı POST isteği göndeririz. Her istek X-Webhook-Signature ve X-Webhook-Timestamp header'larıyla gelir.
Olay Tipleri
| Olay | Açıklama |
|---|---|
| balance.low | Bakiye $2.00 altına düştü |
| balance.depleted | Bakiye sıfırlandı |
| webhook.test | Test bildirimi |
Örnek Payload
İmza Doğrulama (Python)
Hukuk API — İçtihat Denetimi, Taslak & Hesap Motoru
Atıflı hukuk araştırması, kendi şablonlarınızdan taslak üretimi, künye doğrulama ve deterministik hesap motoru.
Platformun ayırt edici kısmı burada: model bir künye üretirse doğrulanır, doğrulanamazsa açıkça işaretlenir —
"teyit edilemedi" ile "yok" ayrı statülerdir. Tüm uçlar X-API-Key ister ve YALNIZ kendi arşivinizde çalışır.
{"doc_name":"kira-sozlesmesi.docx", "text":"..."} → {"doc_id", "doc_name", "chunks"}.
Belge yapı-farkındalıklı parçalanır (MADDE/başlık sınırları korunur).
Ücret: bu üç uç ücretsizdir — sorgu hakkından düşmez, token faturası çıkarmaz.
Hatalar:
400 boş belge · 502 embedding servisi yanıt vermedi.{"query":"Kira tespit davası dilekçesi hazırla...", "model":"claude-sonnet-5"}.
Kendi arşivinizden en ilgili 6 parça bağlam olarak kullanılır.
Otomatik atıf denetimi: taslak üretilir üretilmez künyeleri denetlenir ve sonuç
audit alanında döner —
uydurma künye denetimsiz Word'e gitmez. Yanıt: {"draft", "used_templates", "audit"}.
Künye kuralı: sistem promptu tam künye (
Yargıtay 9. HD, E.2024/1234, K.2024/5678, T.10.05.2024) zorunlu kılar;
künyesini bilmediği kararı ATFETMEZ.
KVKK: kayda yalnız talep metni yazılır — yüklediğiniz dosya bağlamı saklanmaz.
{"text":"...", "model":"claude-sonnet-5"}.
Yanıt:
citations[] — her biri {type, ref, context, daire, status, note, source} (type: karar | aym | madde);
counts{verified, unverified, notfound}; summary; from_ledger (defterden gelen, ücretsiz);
from_official (resmî karar arama ucundan doğrulanan); web_calls.
Statüler:
verified = kaynak URL ile doğrulandı · unverified = teyit edilemedi (kararın var olmadığı anlamına GELMEZ — yayımlanmamış kararlar kamuya açık kaynaklarda bulunmaz) · notfound = bulunamadı ya da deterministik tutarsızlık (ör. esas yılı karar yılından büyük, kapatılmış daireye kapanış sonrası tarihli karar).
Maliyet kademeli: önce defter önbelleği (ücretsiz) → deterministik imkânsızlık denetimi (ücretsiz) → resmî karar arama ucu (web hakkından DÜŞMEZ) → yalnız gerekirse web aramalı model. Web kullanılırsa tier planlarda aylık web hakkından düşer.
{"text":"...", "model":"claude-sonnet-5"} → {"comparison", "clauses", "archive_chunks"}. En çok 12 madde işlenir; sonda en riskli 3 madde özetlenir.
Hatalar:
400 metin boş · 400 arşiv boş (önce /kb/upload ile kendi belgelerinizi yükleyin) · 503 karşılaştırma servisi kullanılamıyor.prev_hash → entry_hash), yani sonradan sessizce değiştirilemez.
/stats → {total_checks, unique_refs, by_status, since}.
/tutanak?refs=E.2021/1 K.2021/2,TBK m.299 → {office, items[], count, chain, generated_at, disclaimer};
refs boşsa hesabın tüm kayıtları döner. chain.ok=false ise zincirin kırıldığı satır broken_at ile bildirilir.
Ücret: ikisi de ücretsiz. Defter TTL'i: doğrulanmış/bulunamamış 180 gün, teyit edilemeyen 30 gün — bayat kayıt yeniden doğrulanır.
Kapsam: tutanak mahkeme kanıtı değildir; ne zaman, hangi kaynağa karşı denetlendiğini gösteren bir iz kaydıdır (yanıttaki
disclaimer alanı bunu taşır).{"prompt", "generated", "final", "doc_kind"} → {"stored", "edit_ratio", "learned_chunks"}. edit_ratio 0 = hiç değiştirmediniz.
Rıza kapısı: içerik saklama rızanız kapalıysa hiçbir şey yazılmaz (
stored:false) — açmak için /privacy/content-consent.
/kb/style-stats öğrenme eğrisini verir: {count, median_edit_ratio, first_half, last_half, trend}. Düzeltme oranı zamanla düşüyorsa trend "iyileşiyor" döner.Ücretsizdir: sorgu hakkından düşmez, token faturası çıkarmaz. Sohbet hattında rakam hesaplatmak yerine bu ucu çağırın — hukuk preset'i de kullanıcıyı buraya yönlendirir.
Gövde:
{"type":"kidem", "params":{...}}. type değerleri: kidem, ihbar, faiz, zamanasimi, brutten_net, fazla_mesai, yillik_izin, ise_iade.
params:
kidem / ihbar: ise_giris, cikis, aylik_brut · faiz: anapara, baslangic, bitis, faiz_tipi (yasal|avans|ozel) · zamanasimi: olay_tarihi, alacak_turu (iscilik_tazminat|ucret|genel_alacak|donemsel|haksiz_fiil|kira_alacagi) · brutten_net: aylik_brut, ay, kumulatif_matrah · fazla_mesai: aylik_brut_ciplak, haftalik_fiili, hafta_sayisi · yillik_izin: ise_giris, cikis, kullanilan_gun · ise_iade: aylik_brut_giydirilmis, guvence_ay (4-8).
DİKKAT — iki farklı yanıt şekli var.
kidem/ihbar/faiz/zamanasimi düz alanlar döner ve tür anahtarı tur'dur (ör. {tur:"kidem", brut, damga, net, tavan_uygulandi}).
brutten_net/fazla_mesai/yillik_izin/ise_iade ise {tip, sonuc, kalemler{...}} döner. Alan adını ona göre okuyun.
Her yanıtta ortak:
hesap_dokumu[] (adım adım), dayanak (yasal madde künyesi), uyarilar[], ve uç tarafından eklenen tablo_guncelleme + disclaimer.
Oran/tavan tabloları kapsam dışı bir tarihe denk gelirse motor uydurmaz: son bilinen değeri kullanır ve uyarilar içinde açıkça söyler.POST gövdesi: {"enabled":true, "improve":false, "purge":false} —
enabled içerik saklama talimatı, improve ürün geliştirme için ayrı ve açık rıza (hizmet şartı değildir),
purge talimat kapatılırken eski kayıtların da silinmesi.
DELETE /privacy/stored-content (KVKK m.11/e) saklanan düzeltme kayıtlarını siler → {"removed": n}.
Her değişiklik zaman damgası ve IP ile denetim kaydına yazılır.base_url=https://www.themaximize.ai/audit/v1 ile bağlayabilirsiniz.
Gövde: {"messages":[...], "model":"auto", "preset":"legal"}; preset ?preset= ile de verilebilir.
Yanıt, standart choices[0].message.content alanına ek olarak maximize{preset, model_used, web_calls, route, web_throttled} taşır.
Güvenlik: dış sistem promptu enjekte edilemez — gövdedeki
role:"system" mesajları sunucuda filtrelenir.Emlak API — İlan Havuzu & Co-Brokerage
Kendi yüklediğiniz ilanlardan oluşan havuz + doğal dil arama + ofisler-arası ortak havuz. Sahibinden kazınmaz;
veri sizin envanteriniz, iletişim bilgileri sahiplerinin bilgisi dahilinde eklenir. Tüm uçlar X-API-Key ister ve YALNIZ kendi havuzunuzda çalışır.
GET /listings/template.csv{"query":"Kadıköy'de 3+1 kiralık", "mode":"", "scope":"kendi"}.
scope:
"kendi" (varsayılan — yalnız kendi havuz) | "ortak" (co-brokerage: paylaşılan cross-office ilanlar da aranır).
Ortak havuzu görebilmek için en az bir AKTİF ilanınızı paylaşmış olmanız gerekir (karşılıklılık). Yanıttaki scope_applied alanı hangi kapsamın gerçekten uygulandığını söyler.
KVKK: cross-office sonuçlarda
contact maskeli, açıklamadaki gömülü telefon/e-posta temizlenmiş, eids_no gizli döner; owner_office ilan sahibinin ofis adıdır (atıf).source="cobroke" + sizin ofis atfınızla gider; müşteri numarası ASLA karşı tarafa aktarılmaz (sizin havuzunuzda cobroke_out kaydında kalır). Sahip ofis kabul/ret eder: POST /listings/leads/{lead_id}/cobroke {"action":"accept"|"reject"} — atıf ancak kabulle geçerli sayılır./listings/{id}/status (aktif|satildi|pasif), /listings/{id}/refresh (tazelik teyidi), /listings/parse (serbest metinden ilan çıkarımı).Ticaret API — Tedarikçi/Alıcı Havuzu
Kendi yüklediğiniz tedarikçi/alıcı kayıtları + web-destekli araştırma. Havuz-dışı iletişim uydurulmaz; cevaptaki havuzla uyuşmayan telefon/e-posta/domain sunucu tarafında yakalanıp uyarıyla işaretlenir.
GET /suppliers/template-birlik.csv). Alanlar: name, role (satici|alici), product, country, city, contact, website, description.{"query":"Bursa'da örme kumaş üreticisi"}. Web araması tier planlarda aylık web hakkından düşer.verified rozeti. Emin değilse doğrulanmış GÖSTERMEZ (uydurmaz). /suppliers/parse: serbest metinden firma alanı çıkarımı.Muhasebe API — Ön-Defter
Fatura/fiş metninden gider-gelir kaydı çıkarımı ve deterministik KDV/stopaj hesabı. İş bölümü nettir: yapay zeka yalnız METİNDEN ALAN ÇIKARIR, rakamı MOTOR hesaplar. Model aritmetiği hiçbir zaman otorite değildir — çıkardığı tutarlar ayrıca aritmetik olarak denetlenir. Ön-muhasebe defteridir; beyanname aracı değildir.
{"text":"...", "model":"claude-sonnet-5"}.
KAYDETMEZ — öneri döner, kullanıcı onaylayıp
POST /expenses ile kaydeder.
Yanıt: çıkarılan alanlar + warnings[].
İki güvence: (1) modelin doldurmadığı tutarlar motorla türetilir — yalnız KDV dahil toplam varsa matrah ayrıştırılır, yalnız matrah varsa KDV eklenir; (2) tutarlar tutarlılık denetiminden geçer —
net × oran ≈ KDV ve net + KDV ≈ toplam uymuyorsa beklenen değeri içeren uyarı döner ve onay ekranında görünür.kind (gider|gelir), date (YYYY-MM-DD), vendor, category, description, net (KDV hariç matrah), kdv_rate (0|1|10|20), kdv, total (KDV dahil), stopaj.
category değerleri: kira, yemek, ulasim, ofis, demirbas, hizmet, pazarlama, personel, vergi_resmi, diger.
GET /expenses?month=YYYY-MM ile aya göre filtrelenir. Eksik tutarlar burada da motorla tamamlanır ve tutarlılık uyarıları warnings alanında döner.{month, count, gelir_net, gider_net, kar_net, kdv_hesaplanan, kdv_indirilecek, kdv_odenecek, kdv_devreden, stopaj_toplam, kategori_dagilimi{}}.
Hesaplanan ve indirilecek KDV farkı pozitifse
kdv_odenecek, negatifse kdv_devreden dolar — ikisi aynı anda dolmaz.
month zorunludur ve YYYY-MM biçiminde olmalıdır (aksi hâlde 400).
Yanıt, her yüzeyde olduğu gibi SMMM yönlendirmesi taşıyan bir
not alanı içerir.Hata Kodları
| Kod | Açıklama |
|---|---|
| 401 | Geçersiz veya eksik API key |
| 402 | Yetersiz bakiye ya da plan tavanı doldu (sorgu/web hakkı) — bakiye yükleyin veya üst plana geçin |
| 403 | Yetkisiz erişim (ör. geçersiz admin secret) |
| 404 | Kayıt bulunamadı — dikey uçlarda yalnız KENDİ havuzunuz görünür; başka ofisin kaydına erişim de 404 döner |
| 429 | Rate limit aşıldı — bekleyin ve tekrar deneyin |
| 500 | Sunucu hatası |
OpenAI Kütüphanesiyle Kullanım
Mevcut OpenAI kodunuzu değiştirmeden kullanabilirsiniz — sadece base_url ve api_key değiştirin. Tüm OpenAI SDK'ları (Python, Node.js, LangChain, vb.) çalışır.
Node.js için:
Hermes Agent ile Kullanım
Nous Research'ün açık kaynak otonom ajanı Hermes Agent, Maximize'ı model sağlayıcısı olarak kullanabilir. Kurulumdan sonra hermes model komutunda Custom endpoint seçin veya ~/.hermes/config.yaml dosyasına şunu yazın:
Araç çağrıları (function calling), streaming ve /v1/models üzerinden otomatik model keşfi desteklenir. Türkiye'de işlenen veriyle çalışması gereken ajanlar için model listesini ?kvkk_yurtici=true ile filtreleyebilirsiniz.