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. 1

    Hesap oluşturun

    solvena.si üzerinden kayıt olun ve e-postanızı doğrulayın.

  2. 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. 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 dosyası
# .env
SOLVENA_API_KEY=API_KEY

Vurgulu alanlar, kendi değerinizle değiştirmeniz gereken yerlerdir.

Bağlantı

Taban adreshttps://api.solvena.si/v1
Kimlik doğrulamaAuthorization: Bearer API_KEY
ProtokolOpenAI Chat Completions (v1)
Modelsolvena-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.

Prompt
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

İ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.

Kayıt ol →