API Anahtarı Alma'dan Hata Ayıklamaya

Başlangıç

İlk API anahtarını nasıl alırım?

API anahtarını alma sayfasını açın, e-posta ve şifre ile kayıt olun. Kayıt tamamlandığında API anahtarınız sayfada hemen görünür. Ödeme bilgisi girmenize gerek yoktur; API anahtarını kopyalayıp ortam değişkenlerine ekleyerek çağrı yapmaya başlayabilirsiniz.

Bir hesapta kaç API anahtarı olabilir?

Bir hesapta yalnızca bir API anahtarı vardır. Değiştirmek isterseniz yeni bir tane oluşturabilirsiniz. Ancak dikkat: Eski API anahtarı hemen geçersiz olur ve eski API anahtarını kullanan tüm hizmetler 401 hatası almaya başlar. Bu yüzden işlemi yapmadan önce yeni API anahtarının dağıtım sürecini hazırlayın.

Uç nokta adresi ve model adı nedir?

Uç nokta adresi https://api.llmzhongzhuan.com/v1，对话请求发往 /v1/chat/completions'dir. Model listesi GET /v1/models ile görüntülenebilir. Yalnızca bir model adı vardır: uncensored.

Mevcut OpenAI kodunu nasıl değiştirmeliyim?

Genellikle yalnızca iki değişiklik yapmanız yeterlidir: base_url'i yukarıdaki adrese, API anahtarını kendi API anahtarınıza ve model alanını uncensored olarak değiştirin. İstek ve yanıt gövdeleri OpenAI sohbet tamamlama formatında kalacağı için büyük çoğunlukla kod değişikliği gerekmez. Çerçeve yapılandırması için Çerçeve Yapılandırması sayfasına bakın.

Kredi ve Faturalandırma

Deneme kredisi ne kadar ve nasıl hesaplanır?

Yeni hesaplara 0,50 $ hediye edilir ve 7 gün geçerlidir. Giriş başına 1 milyon token için 0,25 $ ve çıktı başına 1 milyon token için 1,00 $ fiyatlandırma ile, her istek giriş 800 token ve çıktı 400 token varsayıldığında yaklaşık 0,0006 $ tutarındadır. Bu deneme kredisiyle yaklaşık 800 istek gönderilebilir. Bu bir tahmindir; gerçek kullanım istem uzunluğunuza bağlıdır.

Yükleme yaptıktan sonra bakiye süresi dolar mı?

Hayır. Yükleme yaptığınız ön ödemeli kredi süresi dolmaz. Abonelik yoktur ve bakiye sıfırlanmaz. Yalnızca deneme kredisi 7 gün sonra sona erer.

Bir istek için ne kadar ödeme yaptığımı nasıl öğrenirim?

Yanıtlar usage alanı içerir ve giriş/çıktı token sayısını gösterir. Akış isteklerinde, son yanıt parçası otomatik olarak usage içerir. Bu sayıları birim fiyatla çarparak maliyeti hesaplayabilirsiniz. Kalıcılık (disk yazma) için stabilite uygulamaları sayfasına bakabilirsiniz.

Tam fiyat listesini nerede görebilirim?

Fiyatlar Fiyatlandırma sayfasında belirtilmiştir. Sayfada giriş ve çıkış için birim fiyatlar yer alır; gizli ek ücretler yoktur.

Hatalar ve Hız Limiti

402 hatası ne anlama gelir?

Hata kodu no_credit'tir; hesap bakiyesi bitmiş veya deneme süresi dolmuş demektir. Tek çözüm: ön ödemeli krediyi yükleyin. Bu hatayı tekrar göndermeyin; tekrar göndermek başarısız olur ve gereksiz istek oluşturur.

429 hatası alırsam ne yapmalıyım?

Her API anahtarı için dakikada 300 istek sınırı vardır; bu sınırı aşarsanız 429 alırsınız. Gönderim hızını düşürün ve rastgele gecikmeli backoff stratejisi ile tekrar gönderin. Toplu işlemlerde eşzamanlı istekler için üst sınır ve zamanlayıcı kullanarak gönderimi dengeleyin. Örnek kod istikrar sayfasında yer alır.

503 upstream_busy bir arıza mıdır?

Kalıcı bir arıza değildir; hizmetin geçici olarak meşgul olduğu anlamına gelir. Birkaç saniye sonra tekrar göndermek genellikle başarılı olur. Üstel backoff kullanın ve maksimum tekrar sayısını sınırlayın.

403 content_blocked hatası nedir?

Bu istek içerik filtrelemesini tetikledi. Minörlerle ilgili cinsel içerik, kurgu veya rol yapma olsa bile her zaman 403 hatası döndürür. 403 hatası alırsanız yeniden denemeyin; istek içeriğini kontrol edip düzeltin.

Yetenek Sınırları

Bağlam penceresi ne kadar uzun olabilir? Çıktı ne kadar uzun olabilir?

Bağlam penceresi 100.000 token'dır; giriş ve çıkış toplamı bu sınırı aşamaz. max_tokens varsayılan olarak 2048'dir, tek seferde maksimum 32.000 token ayarlanabilir. Giriş ve max_tokens toplamı sınırı aşarsa 400 hatası döndürülür. Uzun metinler yazarken giriş için yer bırakmayı unutmayın.

Akış ve fonksiyon çağırma destekleniyor mu?

Evet, her ikisi de desteklenir. stream alanını true olarak ayarlayarak SSE akış çıktısı alabilirsiniz. Fonksiyon çağırma OpenAI tools formatını kullanır. temperature, top_p, stop gibi parametreler doğrudan iletilir.

Vektör, resim veya ses işleme yapabilir miyim?

Hayır. Sadece metin sohbeti sağlıyoruz; vektör, görüntü, ses, video ve ince ayar desteği yoktur. Yalnızca bir modelimiz vardır. Bu yeteneklere ihtiyacınız varsa başka çözümler kullanmanız gerekir.

İstek gövdesi için bir boyut sınırı var mı?

Evet, tek bir istek gövdesi 8 MB'ı geçemez. Uzun belgeleri istem olarak eklerken token sayısına ek olarak toplam bayt sayısına da dikkat edin.

Canlıya Alma ve Günlük İşletim

Canlıya almadan önce en çok hangi adımları yapmalıyım?

Önce /v1/models ile model listesini doğrulayın, ardından uzun girişler, akış ve hata yolları içeren testleri çalıştırın. 402, 429 ve 503 hataları için ayrı işleme dalları yazın ve usage bilgisini kalıcı hale getirin. Bakiye uyarısı ayarlayarak yoğun saatlerde bakiyenin bitmesini önleyin. Bu kontrolleri yayınlama sürecine ekleyin ve ilgili kişilere onaylatın.

Canlı ortamda aniden tüm yanıtlar 401 hatası döndürürse önce neyi kontrol etmelisiniz?

Öncelikle arka planda anahtarın yeniden üretilip üretilmediğini doğrulayın, çünkü anahtar yeniden üretildiğinde eski anahtar hemen geçersiz hale gelir. İkinci olarak, ortam değişkenlerinin son yayınlama sırasında kaybolup kaybolmadığını veya anahtarın içinde boşluk ve satır sonu karakterleri olup olmadığını kontrol edin. Geçerli anahtarı yalnızca tek bir yerde tutmak, bu tür sorun giderme işlemlerinin çoğunu ortadan kaldırır.

Birden fazla hizmetin tek bir anahtarı paylaşması durumunda nelere dikkat etmelisiniz?

Hız limiti API anahtarına göre birleştirilir; tüm hizmetlerin toplam isteği dakikada 300'ü geçemez. Bir toplu iş görevi bütçeyi tamamen doldurursa çevrimiçi hizmetler de 429 hatası alır. Toplu işler için ayrı hız limiti ayarlayın, çevrimiçi isteklere öncelik verin ve gerekirse toplu işleri gece saatlerine erteleyin.

Maliyetlerin beklentilerin dışında yükselmesi nasıl önlenir?

Çıktı token'larının birim fiyatı girişin dört katıdır; bu nedenle max_tokens ve istemdeki talep edilen uzunluğu öncelikle kontrol edin. Kullanımı işlevlere göre istatistiklendirin; bir işlevin ortalık çıktı aniden iki katına çıkarsa bunun istem değişikliğinden kaynaklanıp kaynaklanmadığını kontrol edin. Ön ödemeli kredi modeli, bakiye bittiğinde durdurur ve beklenmedik faturalara neden olmaz.

İçerik ve gizlilik

Hangi içeriklere izin verilir?

Yasal yetişkin içeriği, kurgusal eserler ve tartışmalı konular doğrudan reddedilmez; hizmet 18 yaş ve üzeri yetişkin kullanıcılar içindir. Ergenlere yönelik cinsel içerik ise her zaman engellenir. Bu tür hizmetlerin maliyeti ve getirdiği dengeler hakkında sansürsüz AI API'sinin maliyeti ve dengeleri başlıklı makaleyi okuyabilirsiniz.

İstemlerim eğitim için mi kullanılır?

Hayır, istemler eğitim için kullanılmaz. Bunun dışında, bu sayfada depolama veya günlük kaydıyla ilgili diğer ayrıntılar verilmez; lütfen belgelere başvurun.

Bu hizmet, birleştirilmiş (agregatör) bir ara sunucudan nasıl farklıdır?

Bu site yalnızca bir model sunar; eşleşmesi gereken çok sayıda model adı yoktur. Model listesi /v1/models uç noktası üzerinden kendiniz doğrulayabilirsiniz. Ara sunucuların genel çalışma prensipleri ve riskleri hakkında bilgi edinmek için ara sunucu çalışma prensipleri başlıklı makaleyi okumanız önerilir.