Sıkça Sorulan Sorular
Yaygın sorular ve cevapları
Genel Sorular
Onysoft API, OpenAI API formatı ile tam uyumludur. Fark, Onysoft'un birden fazla AI sağlayıcısının modellerini tek bir API üzerinden sunması ve TL cinsinden faturalandırma yapmasıdır.
Evet! Sadece base_url ve api_key değerlerini değiştirmeniz yeterlidir.
OpenAI SDK'ları ile tam uyumludur.
OpenAI (GPT-4, GPT-4o), Anthropic (Claude 3.5), Google (Gemini), Meta (Llama), DeepSeek ve daha fazla sağlayıcının modellerini kullanabilirsiniz.
Faturalama Soruları
Dashboard üzerinden kredi kartı ile TL cinsinden bakiye yükleyebilirsiniz. Ön ödemeli (prepaid) sistem kullanılmaktadır.
Evet, tüm ödemeleriniz için kurumsal e-fatura kesilir. Faturalarınıza Dashboard'dan erişebilirsiniz.
Bakiyeniz sıfırlandığında API istekleri 402 (Payment Required) hatası döndürür. Bakiye yükledikten sonra hizmet otomatik olarak devam eder.
Video / Görsel / Müzik Üretimi
/v1/chat/completions senkron çalışır ve text/chat modelleri içindir
(GPT-4, Claude, Gemini, Llama vb.). Yanıt hemen döner.
/v1/video/generate ise asenkron çalışır ve video, görsel ve müzik
üretimi için kullanılır — önce bir task_id döner, ardından
/v1/video/status/{task_id} ile durumu polling yaparsınız.
Gemini image modelleri (google/gemini-2.5-flash-image gibi) Google
tarafından chat completions formatında sunulur — yanıtın içinde base64 görsel
döner. Bu yüzden /v1/chat/completions üzerinden çağrılır, KieAI
üzerinden gitmez.
i2i modelleri (örn: seedream/4.5-edit, ideogram/v3-edit)
kaynak bir görsel gerektirir. image_url parametresi ile public HTTP
URL veya base64 data URI gönderebilirsiniz. Base64 gönderirseniz sistem otomatik
olarak temp dosyaya kaydeder ve public URL'ye çevirir.
Bu hata genellikle KieAI API'sinden dönen, zorunlu parametrelerin eksik olduğu
anlamına gelir. Sistem çoğu modelin zorunlu parametrelerini otomatik doldurur,
ancak bazı modeller (seedream, gpt-image, flux-2) özel parametreler ister.
Güncel kod bu parametreleri otomatik dolduruyor — hala bu hatayı alıyorsanız,
modelin şu an KieAI tarafında arızalı olabilir. Başka bir model deneyin
(örn: google/imagen4 veya ideogram/v3-text-to-image
her zaman çalışır).
Görsel üretimi: 5-30 saniye. Video üretimi: 30 saniye - 5 dakika (modele ve
sürenin uzunluğuna göre). Müzik üretimi: 30-90 saniye. status
endpoint'ini 5 saniyede bir polling yaparak ilerlemeyi takip edin.
GET /v1/models endpoint'i tüm aktif modelleri ve size uygulanan
markup sonrası fiyatları döner. Alternatif olarak Dashboard'daki
Modeller sayfasını ziyaret edebilirsiniz.
OpenRouter ve KieAI'den yeni modeller çıktığında admin panelindeki Model Senkronizasyonu sayfasından senkronize edilir. Yeni modeller tipik olarak KieAI'nin yayınından sonra 24-48 saat içinde sistemde aktif olur.