TR ▾
API anahtarı al

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.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Model kimliğiuncensored
Base URLhttps://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 penceresi100.000 token (girdi + çıktı)
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
JSON moduresponse_format: {"type": "json_object"}
Fonksiyon çağırmaevet — 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 limitianahtar başına dakikada 300 istek
İstek boyutuen fazla 8 MB
Eşzamanlılıkanahtar başına aynı anda 8 istek
YüklemeUSDT (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)
Fiyat1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50
GirişGoogle veya e-posta ve şifre
İçerikyetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir
Anahtarlarhesap 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.

KodTürAnlamı
400bad_requestgeçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun
401missing_key · invalid_key · key_revokedanahtar yok, yanlış veya değiştirilmiş
402no_creditkredi bitti — yükleyin, hemen devam eder
403content_blockedreşit olmayanları içeren cinsel içerik — reddedildi, ücret yok
404not_foundbilinmeyen uç nokta
413request_too_largegövde 8 MB'tan büyük
429rate_limited · concurrencydakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin
503upstream_busymodel 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.