Geliştiriciler için API dokümantasyonu

Temel URL ve kimlik doğrulama

Temel URL HTTPS://api.ollamaapiurl.com/v1 şeklindedir. Yetkilendirme için benzersiz API anahtarınızı Authorization başlığında iletirsiniz. Bu anahtar, tüm istekler için kimlik doğrulama kimliğiniz olarak işlev görür. Kayıt olduktan hemen sonra panodan alın.

• Anahtarınızı güvende tutun. Ön ödemeli kredinize tam erişim sağlar.
• Ayarlar sayfasından istediğiniz zaman yeni bir anahtar oluşturun.

API anahtarımız sistemi basittir. Hesap başına tek aktif anahtar, net izleme sağlar. Erişimi kaybederseniz, anahtarınızı anında yenileyin. Telefon numarası doğrulaması girişinizi engellemez.

İlk istek

Standart HTTP kullanarak ilk isteminizi gönderin. Uç nokta metin girdisi kabul eder ve metin çıktısı döndürür. Bu yöntem, tercih ettiğiniz herhangi bir HTTP istemci kütüphanesi ile çalışır.

Copycurl https://api.ollamaapiurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the local library"}]
  }'

Yanıt, token kullanımını içerir. İşlenen tokenlar için ödeme yaparsınız. Hatalar ön ödemeli bakiyenizi tüketmez. Bu şeffaflık, harcamalarınızı tam olarak kontrol etmenizi sağlar.

Python SDK entegrasyonu

Resmi OpenAI Python kütüphanesini kullanın. Base URL'yi bizim uç noktamıza yönlendirin. Model ID'sini uncensored olarak ayarlayın. Bu, yerel kurulum zahmetleri olmadan uncensored davranış almanızı sağlar.

Copyfrom openai import OpenAI

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

Kütüphane otomatik olarak yeniden denemeleri ve biçimlendirmeyi yönetir. Yapılandırılmış JSON veya ham metin alırsınız. Akış desteği de mevcuttur. Bu yaklaşım kodunuzu temiz ve sürdürülebilir tutar.

Node SDK kurulumu

openai paketini yükleyin. Temel URL'yi hizmetimize işaret edecek şekilde yapılandırın. API anahtarını ortamınızdan ayarlayın. Bu kurulum, Python yapılandırmasına yakından benzer.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ollamaapiurl.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);

Node geliştiriciler tutarlı davranım elde eder. Model istemlere anında yanıt verir. Bunu herhangi bir web sunucusuna veya arka plan işçisine entegre edebilirsiniz. Karmaşık yönlendirme mantığına gerek yoktur.

Akış yanıtları

Akış özelliğini etkinleştirmek için stream parametresini true olarak ayarlayın. API, oluşturuldukları şekilde parçaları döndürür. Bu, kullanıcılar için algılanan gecikmeyi azaltır. Jetonlar belirdikçe görüntüleyebilirsiniz.

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)

Son chunk toplam jeton sayısını içerir. Bu, faturalandırma doğrulaması için kullanılır. Streaming tüm parametrelerle çalışır. Fonksiyon çağrılarını da destekler. Kullanıcılarınız gerçek zamanlı ilerleme görür.

Limitler, hatalar ve bağlam

Bağlam pencereniz toplam 100.000 token kapsar. Bu hem istem hem de tamamlamayı içerir. İstek başına 16.000 token'a kadar çıktı yapabilirsiniz. Hız sınırı dakikada 300 isteklere izin verir. Eşzamanlı istekler anahtar başına sekizle sınırlıdır.

Yaygın hatalar arasında geçersiz anahtarlar için 401 bulunur. Bir 402 hatası önceden ödenen kredinizin tükendiğini gösterir. Bir 429 yanıtı hız sınırına ulaştığınızı bildirir. Kripto ile yüklemek için panonuzu kontrol edin. Krediler asla süresi dolmaz. Çift ücretlendirme gibi hatalar destek aracılığıyla düzeltilir.