İlk istek beş dakikada
Apertus sansürsüz LLM API'sine dakikalar içinde başlayın. Bu hızlı başlangıç kılavuzu kimlik doğrulama, temel istekler ve OpenAI uyumlu arayüz kullanarak akış işlemini kapsar.
Temel URL & Kimlik Doğrulama
API'ye özel https://api.apertus.top/v1 temel URL'sini kullanarak erişin. Hizmet OpenAI uyumludur, bu nedenle base_url'i güncelleyerek ve API anahtarınızı sağlayarak standart SDK'ları kullanabilirsiniz. Google veya e-posta adresi kullanarak API anahtarı al sayfasında kaydolun. Anahtarınız oluşturulduğunda hemen görüntülenir. Her hesabın tek bir aktif anahtarı vardır; yeni bir tane oluşturmak önceki anahtarı değiştirir. Aylık abonelik veya anahtar süresi sona ermesi yoktur. Ön ödemeli kredi süresi dolmaz ve kullanılmayan bakiye gelecekteki istekler için kullanılabilir. Hatalar ve reddedilen istekler kredinizi tüketmez.
İlk İstek
Bağlantı ve faturalandırmayı test etmek için basit bir metin tamamlama isteği gönderin. Sunucularımızda barındırılan tek açık ağırlıklı modele erişmek için uncensored model kimliğini kullanın. Bu model, yasal yetişkin kullanım için içerik reddi olmadan cevap verecek şekilde ayarlanmıştır. Temel URL https://api.apertus.top/v1 şeklindedir. Fiyatlandırma şeffaftır: 1M girdi token başı $0.25 ve 1M çıktı token başı $1.00. Sadece kullandığınız şey için ödeme yaparsınız.
curl https://api.apertus.top/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."}]
}'
Yanıt oluşturulan metni döndürür. Krediniz yetersizse bir faturalandırma hatası alırsınız. İşleme sırasında oluşan hatalar hesabınızdan ücret almaz. Panelden USDT (TRC20) veya USDC (Base) ile bakiye yükleyebilirsiniz.
Python SDK Entegrasyonu
Resmî OpenAI Python SDK'sini veya uyumlu herhangi bir istemciyi kullanın. base_url değerini https://api.apertus.top/v1 olarak ayarlayın ve API anahtarınızı sağlayın. Bu, OpenAI için tasarlanmış mevcut kod tabanlarından yararlanmanızı sağlar. /v1/chat/completions uç noktası tüm metin oluşturmayı yönetir. Model kimliği uncensored şeklindedir. temperature, top_p ve stop gibi parametreler desteklenir. Akış yanıtları, son parçada token kullanım ayrıntılarını içerir. Yapılandırılmış çıktılar için fonksiyon çağırma ve JSON modu da mevcuttur.
from openai import OpenAI
client = OpenAI(base_url="https://api.apertus.top/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
İstemciyi Apertus temel URL'siyle başlatın. OpenAI sınıfı standart yapılandırma parametrelerini kabul eder. API anahtarınızı iletin ve temel URL'yi https://api.apertus.top/v1 olarak ayarlayın. Bu, mevcut Node.js uygulamalarıyla uyumluluğu sağlar. Tüm istekler için uncensored model kimliği gereklidir. Çıktı uzunluğunu max_tokens ile kontrol edebilirsiniz. Belirtilmezse varsayılan maksimum çıktı 2.048 token olup, istek başına 32.000 tokenlik bir üst sınır vardır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apertus.top/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ışlı Yanıtlar
İsteğinizde stream: true ayarını yaparak akış özelliğini etkinleştirin. API, Sunucu Tarafından Gönderilen Olaylar (SSE) akışı döndürür. Her parça kısmi metni içerir. Son parça, istek için tam token kullanım istatistiklerini içerir. Bu, maliyetleri takip ederken sonuçları gerçek zamanlı olarak görüntülemenizi sağlar. Akış, fonksiyon çağırma dahil tüm parametrelerle çalışır. İstemcinizin SSE olaylarını doğru şekilde işlediğinden emin olun. Bağlam penceresi, istem ve tamamlama birlikte olmak üzere 100.000 token'a kadar destekler.
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)
Limitler, Hatalar & Bağlam
API, anahtar başına dakikada 300 istek için bir hız limiti uygular ve 8 eşzamanlı isteklere izin verir. Maksimum istek gövdesi boyutu 8 MB'dir. Kimlik doğrulama anahtarı geçersizse 401 hatası alırsınız. Ön ödemeli krediniz tükendiğinde, yetersiz bakiye gösteren 402 hatası alırsınız. Hız limiti, dakika başı kota bazında uygulanır. Bağlam penceresi toplam 100.000 token'dır. İstek başına maksimum çıktı 32.000 token'dır. Bu limiti aşan istekler, modelin standart davranışı tarafından işlenir. SLA yüzdeleri garanti edilmez. Gizlilik korunur; istemler eğitim için kullanılmaz.
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 |
| Base URL | https://api.apertus.top/v1 |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Maksimum çıktı | 64.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON modu | response_format: {"type": "json_object"} |
| Bağlam penceresi | 64.000 token (girdi + çıktı) |
| Hız limiti | anahtar başına dakikada 300 istek |
| Eşzamanlılık | anahtar başına aynı anda 8 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 |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Ü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) |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Giriş | Google veya e-posta ve şifre |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
| 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
API anahtarım süresi doluyor mu?
Hayır, API anahtarınız süresi dolmaz. Hesabınızla ilgili aylık abonelikler veya tekrarlayan ücretler yoktur. Anahtarınızı iptal etmeyi seçene kadar sonsuza kadar kullanabilirsiniz.
Hız limitine takılırsam ne olur?
API, anahtar başına dakikada 300 istekle sınırlıdır. Bu aşılırsa, sonraki istekler gecikebilir veya reddedilebilir. Aynı anda 8 eşzamanlı istek de yapabilirsiniz. Bu sınırlar içinde kalmak için kullanımınızı izleyin.
Çıktı, 32.000 tokenı aşarsa kesilir mi?
Model, istek başına maksimum 32.000 token çıktı destekler. Oluşturulan metin bu sınırı aşarsa, yanıt model tarafından kesilir. Çıktı uzunluğunu bu sınır içinde kontrol etmek için <code>max_tokens</code> parametresini ayarlayabilirsiniz.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadardır.