# Aslenty API

Tek müşteri anahtarı, ortak Aslenty TL bakiyesi. Yeni anahtarlar pr_live_ ile başlar; mevcut anahtarlar geçerlidir. Anahtar oluşturulabilir ancak Aslenty bakiyesi pozitif olana kadar pasif kalır. Anahtarını yalnızca sunucunda sakla; sağlayıcı anahtarları ve sağlayıcı kredileri kullanıcıya verilmez. `LOCAL_AI_ENABLED=1` ve yerel worker çalışırken metin/kod istekleri dış AI API’si olmadan bilgisayardaki Ollama modeline gider; `LOCAL_ONLY_MODE=1` tüm dış sağlayıcıları kapatır.

## Metin sohbeti (mevcut uyumlu API)
POST /v1/chat/completions
Authorization: Bearer ANAHTAR
Content-Type: application/json

{"model":"aslenty-text","messages":[{"role":"user","content":"Merhaba"}],"max_tokens":1000}

`aslenty-code` kabul edilir; eski `nova-text` ve `nova-code` adları geriye dönük uyumluluk için tutulur. Yanıt senkron sohbet yanıtıdır. Streaming kapalıdır. Fiyatlar giriş/çıkış belirteçlerine, yöneticinin kuruna ve kâr oranına göre hesaplanır.
GET /v1/account: bakiye. GET /v1/models: etkin model adları.

### Anahtar aktivasyonu ve otomatik yönlendirme

Kullanıcı web panelinden Aslenty API anahtarı oluşturur, ardından kredi talebi oluşturur. Yönetici ödemenin geldiğini benzersiz referansla onayladığında kullanıcının Aslenty bakiyesi yüklenir ve anahtar etkinleşir. Bakiye sıfırsa `/v1/models`, `/v1/services` ve işlem uç noktaları 402 döndürür; `/v1/account` bakiye durumunu göstermek için kullanılabilir.

Web panelindeki tek istek kutusu; araştırma, metin, kod, web sitesi, mobil uygulama, oyun, belge, muhasebe, güvenli sağlık bilgisi, görsel, ses, transkripsiyon ve video taleplerini içeriğe göre uygun Aslenty hizmetine yönlendirir. Son kullanıcı sağlayıcı/model seçmez; yerel worker veya etkin bağlantılar arasından seçim ve maliyet optimizasyonu sunucu tarafında yapılır. Sağlık hizmeti tanı, tedavi veya ilaç kararı vermez; muhasebe çıktıları resmi kayıt öncesi yetkili kontrolü gerektirir.

## Hizmetler ve uzun işlemler
GET /v1/services: hizmetler, kullanılabilirlik ve ücret türü.
POST /v1/jobs: işlem oluştur.
Authorization: Bearer ANAHTAR
Idempotency-Key: uygulamamin-benzersiz-islemi-001
Content-Type: application/json

{"service":"code","prompt":"Python ile basit bir hesap makinesi yaz"}

Yanıt 202 ve işlem id'sidir. GET /v1/jobs/ISLEM_ID ile sonuç alınır. GET /v1/jobs son 50 işlemi listeler. Sadece anahtarın bağlı olduğu hesabın işlemleri görünür.
Aynı isteği aynı Idempotency-Key ile tekrar göndermek ikinci ücretli işlem oluşturmaz. İstek değişirse yeni kimlik kullan. Bağlantı kesilirse yeni kimlik üretme.
Durumlar: queued, running, succeeded, failed, review. review durumunda sonuç belirsizdir; yeniden sağlayıcı isteği yapılmaz ve bakiye inceleme bitene kadar tutulur.

Metin hizmetleri: text, code, website, mobile, game, ai, documents. En fazla 4.000 karakter, 1.000 çıkış belirteci. Mevcut Groq/OpenRouter fiyatları kullanılır. Gerçek kullanımdan kalan ayrılmış bakiye iade edilir. Çıktı kod/metindir; otomatik uygulama yayınlama veya yeni model eğitimi yapılmaz.
research: en fazla 4.000 karakter, web araştırması; ayrıca bağlantı ve işlem fiyatı gerekir.
image: prompt, tek görsel.
image_edit: prompt ve image_url (HTTPS) veya image_base64/image_content_type ile uygulama içi görsel.
speech: prompt, en fazla 1.000 karakter.
transcription: audio_base64 ve isteğe bağlı language (tr/en gibi). RIFF WAV, sıkıştırılmamış PCM, mono, 16 bit, 16–48 kHz, en fazla 60 saniye ve 6 MB. MP3 desteklenmez.
video: prompt, yerel kare tabanlı video.
video_edit: video_url (HTTPS) veya video_base64/video_content_type, start_seconds ve duration_seconds. Varsayılan süre ayarı `.env` içindeki `PLENTYRAM_VIDEO_MAX_SECONDS` değeridir; `0` yerel kaynak sınırlarını kullanır. Bu işlem yalnızca kesme yapar.
health: yalnızca genel bilgi ve rapor açıklaması olarak kullanılabilir; tanı, tedavi, ilaç veya acil durum kararı vermez. Hizmetin açılması ayrıca yönetici yapılandırmasına bağlıdır.

Metin dışındaki açık hizmetler başarılı işlem başına tanımlanan sabit TL fiyatıyla ücretlenir. Bağlantı ve fiyat tamamlanmadan hizmet açılmaz. Aynı hesap için en fazla üç bekleyen işlem vardır.
Medya dosyalarının sağlayıcı bağlantıları süreli olabilir; ihtiyacın olan dosyayı indir.

## Yönetim ve yayın durumu
Sağlayıcı anahtarları yalnızca yöneticinin bağlantılar bölümünden girilir. fal için FAL_API_KEY, seslendirme için ELEVENLABS_API_KEY kullanılır. Değerler müşterilere dönmez.
Kredi talepleri otomatik ödeme değildir. Yönetici yalnızca tahsil ettiği ödemeyi benzersiz referansıyla onaylar. İmzalı sağlayıcı webhook’u `PAYMENT_WEBHOOK_SECRET` yapılandırıldığında `/api/payment/webhook` adresine gönderilebilir; aynı talep veya ödeme referansı ikinci kez kredi yüklemez. Gerçek sağlayıcı adapter’ı ve merchant hesabı ayrıca gerekir.
İşlem verileri SQLite/WAL snapshot ve uyumluluk için `data/store.json` içinde tutulur. Tek sunucu süreci desteklenir. İnternete satış açmadan önce HTTPS, ödeme sağlayıcısı, çoklu süreç kilitleme, veri saklama politikası, off-site yedekleme ve sağlayıcı kullanım koşulları tamamlanmalıdır. Mevcut çalışma yereldir.