Ollama NSFW kullanıcıları için hızlı başlangıç
Herhangi bir OpenAI uyumlu SDK'yı barındırılan uç noktamıza yönlendirerek dakikalar içinde ilk yanıtınızı alın. Bu hızlı başlangıç; kimlik doğrulama, temel sohbet, akış ve sansürsüz modelimizle fonksiyon çağırma konularını kapsar.
Önkoşullar ve Kimlik Doğrulama
Başlamak için bir API anahtarı ve base URL'e ihtiyacınız var. Google veya e-posta ile API anahtarı al sayfasında kaydolun. Anahtarınız hemen görünür; deneme için kart gerekmez. Base URL https://api.ollamansfw.com/v1 şeklindedir. Bunu ortam değişkenlerinize veya SDK yapılandırmanıza ayarlayın. Model tanımlayıcısı uncensored'dir. Bu, GPT veya diğer tedarikçi modellerinden farklı olarak sunucularımızda çalışan açık ağırlıklı bir modeldir.
İlk İsteğiniz
Standart bir sohbet tamamlama isteği gönderin. API, role ve content içeren bir messages dizisi bekler. Bağlantıyı test etmek için curl kullanın. YOUR_API_KEY yerine gerçek anahtarınızı yazın. Yanıt, oluşturulan metni choices[0].message.content içinde döndürür. 401 alırsanız anahtarınızı kontrol edin. 402 alırsanız krediye ihtiyacınız vardır.
Python SDK Entegrasyonu
Resmi openai Python paketini kullanın. Bunu pip aracılığıyla yükleyin. İstemciyi özel base URL ve API anahtarı ile yapılandırın. Bu, uç noktamızla uyumluluğu sağlar. Aşağıdaki kod basit bir metin oluşturmayı gösterir. İsteği işler ve sonucu yazdırır. Hata yönetimi HTTP istisnalarını yakalamalıdır. Bu yaklaşım herhangi bir OpenAI uyumlu istemci için çalışır.
Node.js SDK Entegrasyonu
openai Node.js paketini yükleyin. Base URL ve API anahtarını istemci başlatmasında ayarlayın. Yapı Python örneğini yansıtır. Model ID'si uncensored olarak geçirin. Yanıt tamamlama verilerini içerir. Temiz kod için async/await kullanın. Bu yöntem, doğrudan API erişimi gerektiren sunucu tarafı uygulamaları veya CLI araçları için idealdir.
Akışlı Yanıtlar
stream: true ayarlayarak akışı etkinleştirin. API, sunucu tarafından gönderilen olaylar (SSE) akışı döndürür. Her parça kısmi metin içerir. Son parça token kullanım istatistiklerini içerir. Bu, uzun yanıtlar için algılanan gecikmeyi azaltır. Akış hatalarını zarifçe yönetin. SDK'lar yerleşik akış yineleyicileri sağlar. Arayüzü gerçek zamanlı güncellemek için her parçayı işleyin.
Limitler, Hatalar ve Bağlam
Bağlam penceresi toplamda 100,000 tokendir. Çıktı pencerenin sonuna kadar uzayabilir. Hız limiti dakikada 300 istektir. Eşzamanlı istekler anahtar başına 8 ile sınırlıdır. İstek gövdeleri 8 MB altında olmalıdır. Yaygın hatalar: 401 (geçersiz anahtar), 402 (yetersiz kredi), 429 (hız limiti). Hatalar krediyi tüketmez. Yasal olmayan içerikler için reddetmeler ücretsizdir. Kredi asla sona ermez.
cURL
curl https://api.ollamansfw.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
from openai import OpenAI
client = OpenAI(base_url="https://api.ollamansfw.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.ollamansfw.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ış
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)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 |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Model kimliği | uncensored |
| Base URL | https://api.ollamansfw.com/v1 |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON modu | response_format: {"type": "json_object"} |
| 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 |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Hız limiti | anahtar başına dakikada 300 istek |
| İstek boyutu | en fazla 8 MB |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Yükleme | USDT (TRC20) veya USDC (Base), $20–$500 arası herhangi bir tam tutar |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Ü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) |
| Fiyat | 1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50 |
| 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
Bu resmi Ollama API'si mi?
Hayır, bu bağımsız barındırılan bir API'dir. Kendi sansürsüz modelimizi OpenAI uyumlu bir uç nokta üzerinden sunuyoruz. Ollama ile bağlantılı değildir, ancak benzer kuralları kullanır.
Kredi bakiyemi nasıl yüklerim?
USDT (TRC20) veya USDC (Base) kullanarak bakiye yükleyin. Minimum tutar $20'dir. Daha büyük yatırımlar için bonuslar geçerlidir. Kredi gerçek token kullanımına göre yüklenir. Hatalar ve reddetmeler ücretsizdir.
Bağlam penceresi boyutu nedir?
Toplam bağlam penceresi istem ve tamamlama için birlikte 100.000 token'dır. max_tokens ayarlanmazsa, yanıt pencerenin sonuna kadar uzayabilir.