Dokümantasyon
Entegrasyon kılavuzu
Solvena SI, OpenAI uyumlu bir API'dir. Resmî openai SDK'sını kullanırsınız; yalnızca taban adres ve API anahtarı değişir. Bu sayfa ilk isteğinize kadar olan yolu anlatır, tüm uç noktalar API referansındadır.
3 adımda başlayın
- 1
Hesap oluşturun
solvena.si üzerinden kayıt olun ve e-postanızı doğrulayın.
- 2
API anahtarı üretin
Konsolda API anahtarları sayfasından sk- ile başlayan bir anahtar oluşturun. Anahtar yalnızca bir kez gösterilir.
- 3
Anahtarı ortam değişkenine koyun
Anahtarı koda gömmeyin; SOLVENA_API_KEY ortam değişkeninden okuyun.
API anahtarı nereye yazılır?
Örneklerde API_KEY yazan yere konsolda oluşturduğunuz sk- ile başlayan anahtarı koyun. Anahtarı sunucu tarafında tutun; tarayıcı veya mobil uygulama koduna eklemeyin.
# .env
SOLVENA_API_KEY=API_KEYVurgulu alanlar, kendi değerinizle değiştirmeniz gereken yerlerdir.
Bağlantı
| Taban adres | https://api.solvena.si/v1 |
|---|---|
| Kimlik doğrulama | Authorization: Bearer API_KEY |
| Protokol | OpenAI Chat Completions (v1) |
| Model | solvena-lime |
| İstemci zaman aşımı | 600 sn önerilir |
Eski adres https://api.solvena.io/v1 geçiş süresince aynı şekilde çalışır.
İlk istek
Aynı istek üç farklı şekilde. Hepsi anahtarı SOLVENA_API_KEY ortam değişkeninden okur.
curl https://api.solvena.si/v1/chat/completions \
-H "Authorization: Bearer $SOLVENA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "solvena-lime",
"messages": [{"role": "user", "content": "Merhaba! Kendini bir cümleyle tanıtır mısın?"}]
}'Kod asistanınıza yaptırın
Aşağıdaki metni Cursor, Claude Code, GitHub Copilot veya ChatGPT gibi bir kod asistanına yapıştırın. Asistan, entegrasyonu projenize uygun şekilde ekler. API_KEY değerini kendiniz girersiniz.
Projeme Solvena SI API entegrasyonu ekle.
Bağlantı bilgileri:
- Taban adres: https://api.solvena.si/v1
- Protokol: OpenAI Chat Completions (v1) uyumlu. Resmî "openai" SDK'sını kullan; yalnızca base_url ve api_key değişir.
- Kimlik doğrulama: Authorization: Bearer API_KEY
- Model: solvena-lime
- İstemci zaman aşımı: 600 saniye
- Tam API referansı: https://api.solvena.si
Gereksinimler:
1. API anahtarını SOLVENA_API_KEY ortam değişkeninden oku. Anahtarı koda gömme, tarayıcı veya mobil istemci koduna koyma.
2. .env.example dosyasına SOLVENA_API_KEY=API_KEY satırını ekle.
3. Tek bir yardımcı fonksiyon yaz: mesaj listesini alsın, solvena-lime modeline göndersin ve yanıt metnini döndürsün.
4. Geçersiz anahtar (401), istek sınırı (429) ve zaman aşımı hatalarını anlaşılır mesajlarla ele al.
5. Gerekli paket kurulum komutunu ve kısa bir kullanım örneğini göster.
API_KEY değerini ben gireceğim; sk- ile başlıyor.Prompt API anahtarınızı içermez; anahtarı yalnızca kendi ortamınızda tanımlayın.
Modeller
solvena-limeGenel amaçlı varsayılan model.solvena-lime-fastsolvena-lime için takma ad; hız öncelikli kısa işler için.solvena-lime-thinksolvena-lime için takma ad; daha fazla düşünme gerektiren görevler için.
Anahtarınızın erişebildiği modeller konsolda ve /v1/models yanıtında listelenir.
API'de neler var
Sohbet
Mesajlara yanıt üreten ana uç nokta.
Gömme
Metni arama ve benzerlik için vektöre çevirir.
Ses
Ses ile ilgili uç noktalar.
Modeller
Erişebildiğiniz modelleri listeler.
Durum
Servis durumunu bildirir.
- Tüm uç noktalar, parametreler ve örnek yanıtlarTam API referansı
İpuçları
- Anahtarı sunucuda tutun; istemci uygulamalar kendi sunucunuz üzerinden istek atsın.
- Her ortam (geliştirme, üretim) için ayrı anahtar oluşturun; gerekirse konsoldan iptal edin.
- Uzun yanıtlar için istemci zaman aşımını 600 saniye yapın.
- Kullanımınızı ve limitlerinizi konsoldaki Kullanım ve Limitler sayfalarından izleyin.
Anahtarınız hazır mı?
Hesabınız yoksa birkaç dakikada oluşturabilirsiniz.