Ollama kullanıcıları için hızlı başlangıç

Önkoşullar

Bu API'yi kullanmak için geçerli bir API anahtarına sahip aktif bir hesabınız olmalıdır. Google veya e-posta ve şifre ile API anahtarını alın sayfasında kaydolun. Telefon numarası gerekmez. Makinenizde desteklenen bir dil SDK'sının yüklü olması gerekir. Bu kılavuz, OpenAI uyumlu uç noktalar için en yaygın istemciler olan Python ve Node.js'i kapsar. API, uncensored kimliğiyle tek bir sansürsüz modeli sunar. Metri kabul eder ve metrik döndürür. Gömme, görüntü veya ses özellikleri yoktur. Tüm istekler https://api.ollamaapi.cc/v1 adresine gider.

SDK'yı Yükleyin

Tercih ettiğiniz dil için resmi SDK'yı yükleyin. Python için pip kullanın. Node.js için npm kullanın. Bu kütüphaneler HTTP protokolünü, JSON serileştirmesini ve akışı otomatik olarak yönetir. Kontrol seviyesini tercih ediyorsanız ham HTTP istekleri yazmanıza gerek yoktur. SDK'lar iyi belgelenmiştir ve üretim ortamlarında yaygın olarak kullanılır. Ortamınızın SDK gereksinimleriyle eşleştiğinden emin olun. Python 3.8+ ve Node.js 18+ önerilir. Uyumluluk sorunlarından kaçınmak için bağımlılıklarınızı güncel tutun.

İstemciyi Yapılandırın

Temel URL'yi uç noktamıza ayarlayın. OpenAI'dan sansürsüz hizmetimize geçmek için gereken tek yapılandırma değişikliği budur. API anahtarınızı yetkilendirme başlığı olarak iletin. SDK geri kalanını halleder. Model adını gpt-4 veya benzeri olarak değiştirmeyin; uncensored kullanın. API, OpenAI chat-completions protokolünü sıkı bir şekilde takip eder. OpenAI ile çalışan herhangi bir istemci, bu iki değişiklikle burada da çalışacaktır. Bu, geçişi veya A/B testlerini kolaylaştırır. Çıktıları karşılaştırmak için her iki API'yi paralel olarak çalıştırabilirsiniz.

İlk İsteği Gönderin

/v1/chat/completions adresine POST isteği gönderin. Model kimliğini, sistem istemini ve kullanıcı mesajını ekleyin. API bir metin yanıtı döndürür. Krediniz varsa istek başarılı olur. Kredi yoksa 402 hatası alırsınız. Anahtarınız geçersizse 401 alırsınız. Bu hatalar standarttır ve kodda kolayca işlenebilir. Model yasal yetişkin içeriği reddetmez; bu da yaratıcı yazım, güvenlik araştırmaları veya sansürsüz sohbet için kullanışlıdır. Kalan kredilerinizden emin değilseniz kontrol panelinden bakiyenizi kontrol edin.

Akış Yanıtları

stream: true ayarlayarak akışı etkinleştirin. API, tokenlar oluşturuldukça onları döndürür. Bu, kullanıcılar için algılanan gecikmeyi azaltır. Son parça, faturalandırma için toplam token kullanımını içerir. Akış, tüm resmi SDK'lar tarafından desteklenir. Metnin yazıldığı gibi gösterilmek istendiği sohbet arayüzleri için önemlidir. Sunucu SSE (Sunucu Tarafından Gönderilen Olaylar) gönderir. İstemci kitaplığınız ayrıştırmayı yönetir. Özel bir istemci oluşturmadıkça olay akışını manuel olarak yönetmenize gerek yoktur.

Limitler, Hatalar ve Bağlam

Bağlam penceresi toplam 100.000 token, maksimum çıktı 32.000 token'dır. İstekler dakika başına 300 ve anahtar başına 8 eşzamanlı istekle sınırlıdır. İstek gövdesi 8 MB'ın altında olmalıdır. Hatalar arasında geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız limitleri için 429 bulunur. Bunlar standart HTTP kodlarıdır. Bunları uygulamanızda zarifçe yönetin. Model, çocuklarla ilgili cinsel içerik bloklar. Diğer tüm içeriklere izin verilir. Kredi geçerliliğini kaybetmez, bu nedenle fonları kaybetmeden kullanıma ara verebilirsiniz. İade sorunları için destek sayfasını kullanın.

cURL

Copycurl https://api.ollamaapi.cc/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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.ollamaapi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapi.cc/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ış

Copystream = 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)