Sıkça Sorulan Sorular

Yaygın sorular ve cevapları

Genel Sorular

Onysoft API ile OpenAI API arasındaki fark nedir?

Onysoft API, OpenAI (Chat Completions ve Responses) ile Anthropic Messages API biçimleriyle uyumludur. Fark, Onysoft'un birden fazla üreticinin modellerini tek bir API ve tek anahtarla sunması ve TL ile ödeme almasıdır.

Mevcut OpenAI kodumu Onysoft'a geçirebilir miyim?

Evet. Çoğu durumda base_url ve api_key değerlerini değiştirip model alanına katalogdaki sağlayıcı/model kimliğini yazmanız yeterlidir. İletilen istek alanları ve bilinen farklar için Chat Completions bölümüne bakın.

Hangi modelleri kullanabilirim?

OpenAI (GPT-6 Astra/Sol/Luna, GPT-5.6 Sol/Terra/Luna), Anthropic (Claude Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5), Google (Gemini 4 Argon, Gemini 3.8 Flash, Gemini 3.1 Pro önizleme), xAI (Grok 4.7, Grok 4.20), Meta (Muse Spark 1.3, Llama 4), DeepSeek (V4.1 Flash, V4 Pro), Qwen (Qwen3.8 Max Prime, Qwen3.8 Flash), Mistral (Mistral Large) ve daha fazla üreticinin modellerini kullanabilirsiniz. Güncel liste Modeller sayfasındadır.

Claude Code, Codex ya da Cursor ile kullanabilir miyim?

Evet. Claude Code Anthropic Messages API ucuyla (ANTHROPIC_BASE_URL=https://api.onysoft.com), Codex CLI Responses API ucuyla (base_url = "https://api.onysoft.com/v1", wire_api = "responses"), Cursor ise "Override OpenAI Base URL" ayarıyla çalışır. Adımlar: Claude Code, Codex CLI, Cursor.

Faturalama Soruları

Nasıl ödeme yaparım?

Panelden kredi kartı ya da banka havalesiyle TL bakiye yükleyebilirsiniz. Ön ödemeli (prepaid) sistem kullanılmaktadır.

Fatura alabilir miyim?

Evet. Bakiye yüklemeleriniz için fatura bilgilerinize göre e-Fatura (kurumsal) ya da e-Arşiv fatura (bireysel) düzenlenir; e-Fatura GİB üzerinden e-fatura kutunuza, e-Arşiv fatura e-posta adresinize gönderilir.

Bakiyem biterse ne olur?

Bakiye sıfırlanmadan da 402 (Payment Required) alabilirsiniz: her istekten önce tahmini tavan maliyet bakiyenizle karşılaştırılır (bkz. Hata Kodları → Bakiye ön kontrolü). Ücret gerçek kullanımdan kesilir. Bakiye yükledikten sonra hizmet otomatik olarak devam eder.

Bakiyem varken neden 402 alıyorum?

Her istekten önce tahmini tavan maliyet (girdi + max_tokens, gönderilmezse modelin azami çıktısı, %20 güvenlik payıyla) bakiyenizle karşılaştırılır; bakiye bunun altındaysa 402 döner. Ücret gerçek kullanımdan kesilir. max_tokens değerini düşürün ya da bakiye yükleyin; ayrıntı Bakiye ön kontrolü bölümünde.

Video / Görsel / Müzik Üretimi

Chat API ile Video API arasındaki fark nedir?

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

Google Gemini image modelleri neden chat endpoint'inde?

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, /v1/video/generate üzerinden gitmez.

Image-to-image (i2i) modeller nasıl çalışır?

i2i modelleri (örn: seedream/4.5-edit-i2i, ideogram/v3-edit-quality-i2i) 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.

"This field is required" hatası alıyorum, ne yapmalıyım?

Bu hata genellikle üretim servisinden 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, model şu an geçici olarak kullanılamıyor olabilir. Başka bir model deneyin (örn: google/imagen4-t2i veya ideogram/v3-text-to-image-quality).

Üretim ne kadar sürer?

Görsel üretimi: 10-30 saniye. Video üretimi: 30 saniye - 3 dakika (modele ve sürenin uzunluğuna göre). Müzik üretimi: 30-90 saniye. status endpoint'ini 5-10 saniyede bir polling yaparak ilerlemeyi takip edin.

Tüm modellerin güncel fiyatlarına nereden bakabilirim?

GET /v1/models endpoint'i tüm aktif modelleri anahtarınıza göre fiyatlarıyla döner. Alternatif olarak Dashboard'daki Modeller sayfasını ziyaret edebilirsiniz.

Yeni modeller ne sıklıkla eklenir?

Yeni modeller otomatik senkronizasyonla kataloğa eklenir. Genellikle resmi yayınlarından sonraki 24-48 saat içinde kullanılabilir hale gelir.

Size uygun modeli bulmanıza yardımcı olayım mı?