tr ▾

Ollama endpoint API Dokümantasyonu

Saniyeler içinde uncensored LLM API'mizle geliştirmeye başlayın. Bu kılavuz; temel URL, kimlik doğrulama ve OpenAI uyumlu API iş akışlarınız için SDK entegrasyonunu kapsar.

Temel URL ve Kimlik Doğrulama

Her istek için sağlanan temel URL'yi ve bir API anahtarını kullanın. Uç nokta https://api.ollamaendpoint.com/v1Yetkilendirme header'ı Bearer token olarak kullanın. Bu anahtarı Google veya e-posta ile giriş yaptıktan hemen sonra oluşturursunuz. Anahtar hesap başına özeldir ve önceki aktif anahtarı yerine geçirir.

İlk İstek

Metin oluşturmak için standart bir sohbet tamamlama gönderin. Model kimliği uncensored ve standart OpenAI istemcileriyle aynı parametreleri kabul eder. Bu, NSFW LLM görevleri veya kısıtlamasız içerik üretimi için geçerlidir.

  • Yöntem: POST
  • Uç nokta: /v1/chat/completions
  • Model: uncensored
curl https://api.ollamaendpoint.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Get the local ip address of this machine"}]
  }'

Başarılı bir yanıt, oluşturulan metni choices dizisi içinde döndürür. Şunu kontrol edin: usage alanı, token sayılarını görmek için.

Python SDK Entegrasyonu

Resmi OpenAI kitaplığını yükleyin ve temel URL'yi yapılandırın. Bu, tanıdık Python koduyla uncensored ollama modelini kullanmanıza olanak tanır. Ayarlayın base_url ve api_key istemciyi başlatmadan önce. Kod, mevcut OpenAI SDK'ları ile uyumlu kalır.

from openai import OpenAI

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

Şunu çağırın chat.completions.create GPT için yapacağınız gibi yöntem. Yanıt yapısı standart beklentileri karşılar. Akış yapabilir veya tam yanıtlar alabilirsiniz.

Node SDK Entegrasyonu

API ile etkileşim kurmak için Node.js OpenAI paketini kullanın. İstemciyi özel temel URL ve API anahtarınızla yapılandırın. Bu yaklaşım sunucu tarafı uygulamaları veya kenar işlevleri için çalışır. Paket serileştirmeyi ve yeniden denemeleri otomatik olarak yönetir.

import OpenAI from "openai";

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

İsteğinizle birlikte completion uç noktasını çağırın. Kitaplık, yanıt nesnesine çözülen bir promise döndürür. Hataları standart HTTP durum kodlarına göre işleyin.

SSE ile Akış Yanıtları

Ayarlayarak akışı etkinleştirin stream: true istekinizde. Sunucu, Sunucu Gönderilen Olaylar (SSE) akışı döndürür. Her parça kısmi metin ve token kullanım verisi içerir. Son parça, faturalandırma için tam kullanım istatistiklerini içerir. Bu, uzun çıktılar için algılanan gecikmeyi azaltır.

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)

Tam yanıtı yeniden oluşturmak için her parçadan gelen içerik parçalarını birleştirin. Akışta gelen hataları işleyin. Son parça, ön ödemeli krediniz için token sayısını onaylar.

Saniye Başına İstek Limitleri ve Kısıtlamalar

Her API anahtarı dakikada 300 istek ve 8 eşzamanlı istek destekler. Maksimum istek gövdesi boyutu 8 MB'tır. Bağlam penceresi, istem ve tamamlama birlikte 100,000 token içindir. Çıktı limitleri istek başına 16,000 token'dır. Hatalar ve reddetmeler krediyi tüketmez. 401 hatası anahtarınızın geçersiz olduğunu belirtir. 402 hatası yetersiz ön ödemeli kredi olduğunu gösterir. 429 hatası hız sınırına ulaştığınızı belirtir. Limitler içinde kalmak için eşzamanlılığı ayarlayın.

SSS

Ollama uç noktası için temel URL nedir?

Temel URL HTTPS://api.ollamaendpoint.com/v1 şeklindedir. Tüm API çağrıları için bunu kullanın. Standart OpenAI istemcileri ile uyumludur.

Akış yanıtlarını nasıl yönetebilirim?

stream parametresini true olarak ayarlayın. API, Sunucu Tarafından Gönderilen Olaylar döndürür. Son metni oluşturmak için her parçayı işleyin. Son parça, kullanım verilerini içerir.

Bir hız limitine takılırsam ne olur?

429 durum kodu alırsınız. Limit anahtar başına dakikada 300 istektir. Eşzamanlılığı azaltın veya yeniden denemeden önce bekleyin. Eşzamanlı istekler 8 ile sınırlandırılmıştır.

API Anahtarınızı Alın

Kaydolun, anahtarı alın, yeni temel URL'ye yönlendirin. Tamam.

Şimdi başla