Hızlı Başlangıç: LLM Proxy'yi Entegre Edin
Tek bir temel URL değişikliğiyle sansürsüz LLM proxy'mizi entegre edin. Tak-çıkar OpenAI uyumluluğu, mevcut kodunuzun değişiklik yapmadan çalışacağı anlamına gelir.
Temel URL ve Kimlik Doğrulama
Standart OpenAI temel URL'nizi bizim uç noktamızla değiştirin. Kimlik doğrulama, Authorization başlığında Bearer token kullanılarak yapılır. Bu yaklaşım herhangi bir OpenAI uyumlu istemci kütüphanesiyle çalışır. Kod mantığınızı değiştirmenize gerek yoktur, yalnızca yapılandırma değerlerini değiştirin. API'miz standart OpenAI arayüz yapısını taklit eder, böylece mevcut entegrasyon kodunuz geçerliliğini korur. Bu, entegrasyon süresini günlerden dakikalara indirir. Anahtarınızı istediğiniz zaman panelden yeniden oluşturabilirsiniz; bu, eski anahtarı hemen geçersiz kılar. Bu, uygulamanızda karmaşık token döndürme mantığı gerektirmeden güvenlik sağlar.
İlk İstek
Bağlantıyı test etmek için standart bir sohbet tamamlama isteği gönderin. Uç nokta, bir model tanımlayıcısı ve mesaj geçmişi içeren JSON yüklerini kabul eder. Model kimliğimiz "sansürsüz"dür. Bu tanımlayıcı, proxy'nin isteğinizi hangi sansürsüz modele yönlendireceğini belirtir. Yanıt yapısı OpenAI formatını yansıtır ve asistanın mesaj içeriğini içerir. JSON çıktısındaki content alanını kontrol ederek yanıtı doğrulayabilirsiniz. Bu, kimlik doğrulamanızın ve yük yapınızın doğru olduğunu onaylar. Uç nokta, standart istekler için hem akış hem de akış olmayan modları destekler.
curl https://api.llmproxyapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK Entegrasyonu
API'mizle etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanın. api_key değerini proxy anahtarınıza ve base_url değerini uç noktamıza ayarlayın. Kütüphanenin geri kalan davranışı standart OpenAI kullanımıyla aynı kalır. Bu, eşzamanlı istemciler, yeniden denemeler ve standart hata yönetimini içerir. Normalde kullanacağınız temperature ve max_tokens gibi parametreleri iletebilirsiniz. Proxy, arka planda sansürsüz modele yönlendirmeyi halleder. Bu sayede mevcut Python kod tabanınızı korurken modelimizin yeteneklerine erişim elde edersiniz.
from openai import OpenAI
client = OpenAI(base_url="https://api.llmproxyapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node SDK Entegrasyonu
Node.js SDK, temel URL'yi geçersiz kilarak API'mizle çalışır. İstemciyi vekil API anahtarınız ve doğru uç nokta ile başlatın. chat.completions.create gibi diğer tüm yöntemler beklendiği gibi çalışır. Bu, standart yanıt nesnelerini ve hata türlerini işlemeyi içerir. OpenAI ile kullanacağınız aynı mesaj yapılarını ve parametreleri kullanabilirsiniz. Vekil, isteğin sansürsüz model tarafından işlendiğinden emin olur. Bu uyumluluk, geliştiriclerin istemci mantığını yeniden yazmadan sağlayıcıları hızlıca değiştirmesine olanak tanır. Zaten OpenAI SDK desenini kullanan mikro hizmetler için idealdir.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.llmproxyapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Akış Yanıtları
İsteğinizde stream parametresini true olarak ayarlayarak akış özelliğini etkinleştirin. API, Sunucu Tarafından Gönderilen Olaylar (SSE) akışı döndürür. Her parça, yanıtın gerçek zamanlı görüntülenmesine olanak tanıyan kısmi token güncellemelerini içerir. Bu, sohbet arayüzleri ve anında geri bildirim gerektiren uygulamalar için kritik öneme sahiptir. Akış, tam yanıt meta verilerini içeren son parça ile sona erer. Parçaları tercih ettiğiniz dildeki standart SSE kütüphanelerini kullanarak ayrıştırmak mümkündür. Bu özellik, ayrıştırma mantığını otomatik olarak yöneten OpenAI SDK'ları ile sorunsuz çalışır. Tüm yanıt oluşturulmayı beklemeden akıcı bir kullanıcı deneyimi sağlar.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Hız Limitleri ve Kısıtlamalar
API'miz, anahtar başına dakikada 300 istek için bir hız limiti uygular. Bu sınırı aşarsanız 429 durum kodu alırsınız. Bu durumlar için üstel geri çekilme ile yeniden deneme mantığı uyguladığınızdan emin olun. İstek gövdesi boyutu 8 MB ile sınırlıdır. Bu kısıtlama, istem ve bağlamı içeren toplam JSON yükü için geçerlidir. Fiyatlandırma kullanım bazlıdır: milyon girdi token başı $0.25 ve milyon çıktı token başı $1.00. Krediler ön ödemelidir ve süresi dolmaz. Bakiyeniz yetersizse istekler 402 hatası döndürür. Kimlik doğrulama hataları 401 durum kodu döndürür. Karmaşık yönlendirme veya tedarikçi seçimi yoktur; model sabittir.
API özellikleri
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.llmproxyapi.com/v1 |
| JSON modu | response_format: {"type": "json_object"} |
| Bağlam penceresi | 64.000 token (girdi + çıktı) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Maksimum çıktı | 64.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| İstek boyutu | en fazla 8 MB |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| Giriş | Google veya e-posta ve şifre |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Embedding veya görüntü oluşturma sunuyor musunuz?
Hayır, embedding, görüntü, ses veya video oluşturma sunmuyoruz. API'miz yalnızca metin sohbet tamamlamaları içindir. Embedding'e ihtiyacınız varsa ayrı bir hizmet veya model kullanmalısınız. Odak noktamız sansürsüz modelle yüksek performanslı metin çıkarımıdır.
Bu resmi bir OpenAI hizmeti mi?
Hayır, bağımsız bir hizmetiz. OpenAI API formatıyla uyumluuz ancak kendi sansürsüz modelimizi barındırıyoruz. Bu GPT-4, GPT-3.5 veya başka bir OpenAI modeli değildir. Aynı SDK'ları kullanabilirsiniz ancak altta yatan model farklıdır.
Kredimi aşarsam ne olur?
İstekler 402 Payment Required hatası döndürür. Hesabınızı kripto (USDT veya USDC) kullanarak istediğiniz zaman yükleyebilirsiniz. Krediler asla süresi dolmaz, bu nedenle uygun gördüğünüzde bakiye yükleyebilirsiniz. Aylık abonelik ücreti yoktur, yalnızca kullandıkça öde sistemi vardır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadar.