İlk istek beş dakikada

Temel URL ve Kimlik Doğrulama

OpenAI SDK'nızı veya herhangi bir uyumlu istemciyi temel URL'mize yönlendirin. Belirli bir kütüphaneye ihtiyacınız yoktur; standart bir API anahtarı kabul eden herhangi bir araç burada çalışır. Google veya e-posta ile giriş yaptıktan sonra anahtarınızı panelden alın. Anahtar hemen görüntülenir ve tüm istekler için tek gerekli kimlik bilgisi budur.

Temel URL'yi https://api.ollamaapi.top/v1 olarak ayarlayın. Tüm sohbet tamamlamaları için uncensored model kimliğini kullanın. Bu model açık ağırlıklıdır, daha az reddedilme için ayarlanmıştır ve büyük sağlayıcı modellerinden farklıdır. GPT, Claude veya başka bir özel model değildir. Kimlik doğrulama yalnızca Bearer token başlığına dayanır.

İlk İstek

Bağlantıyı test etmek için standart bir sohbet tamamlama isteği gönderin. Uç nokta, messages, model ve isteğe bağlı temperature veya max_tokens gibi parametreler içeren JSON yüklerini kabul eder. Model kimliği her zaman uncensored şeklindedir. Yanıtlar, asistanın içeriğini ve token kullanım metriklerini içeren yapılandırılmış JSON olarak döndürülür.

İstek başarılı olursa 200 OK yanıtı alırsınız. Kimlik doğrulama başarısız olursa 401 hatası alırsınız. Fonlarınız yoksa 402 hatası alırsınız. Bu hatalar ücretsizdir, bu nedenle yalnızca başarılı token kullanımı için ödeme yaparsınız. Uygulamanıza entegre etmeden önce yapılandırmanızı doğrulamak için bu örneği kullanın.

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

Resmi OpenAI Python kütüphanesini veya herhangi bir uyumlu istemciyi kullanın. İstemciyi temel URL'niz ve API anahtarınızla başlatın. Modeli uncensored olarak ayarlayın. Mesajlarınızı role ve content içeren bir sözlük listesi olarak iletin. Kütüphane seri hale getirme ve yanıt ayrıştırmayı otomatik olarak halleder.

Akış yanıtları stream parametresi aracılığıyla desteklenir. Bu, tokenlar oluşturulurken bunları işlemenizi sağlar; bu, uzun çıktılar veya gerçek zamanlı kullanıcı arayüzü güncellemeleri için faydalıdır. Son parça, faturalandırma için toplam token kullanımını içerir. Ağ hataları ücretlendirmeye neden olmadığından, özel durumları zarif bir şekilde işlediğinizden emin olun.

Copyfrom openai import OpenAI

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

openai npm paketini yükleyin veya herhangi bir fetch tabanlı sarmalayıcı kullanın. İstemciyi temel URL https://api.ollamaapi.top/v1 ve API anahtarınızla yapılandırın. Model kimliği uncensored olarak kalır. İstek gövdesini messages ve isteğe bağlı top_p veya seed ayarlarıyla iletin.

Node.js kullanıcıları temiz kod için async/await desenlerinden yararlanabilir. Yanıt nesnesi choices, usage ve id içerir. Asistanın mesajını ilk seçenekten çıkarabilirsiniz. Hata yönetimi, hız limitleri (429) ve yetersiz kredi (402) durumlarını dikkate almalıdır. Bu hatalar token tüketmez, bu nedenle ön ödemeli bakiyeniz başarılı bir yanıt oluşturulana kadar bozulmadan kalır.

Copyimport OpenAI from "openai";

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

İsteğinizde stream: true ayarlayarak akışı etkinleştirin. API, Sunucu Tarafı Olayları (SSE) akışı döndürür. Her parça kısmi içerik içerir, bu da tokenların oluşturulurken görüntülenmesine olanak tanır. Bu, kullanıcılar için algılanan gecikmeyi azaltır ve uzun metin üretimi için deneyimi iyileştirir.

Akıştaki son parça, tam token kullanım verilerini içerir. Tüketimi gerçek zamanlı olarak izlemek için bunu kullanabilirsiniz. Akışın fiyatlandırma modelini değiştirmediğini unutmayın; hâlâ 1M girdi ve çıktı token başına ödeme yaparsınız. Akış sırasında oluşan hatalar da ücretsizdir. Bağlantı koparsa, isteği ceza ödemeden devam ettirebilir veya yeniden başlatabilirsiniz.

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)

Sınırlar, Hatalar ve Bağlam

Bağlam penceresi, hem istem hem de tamamlama dahil olmak üzere toplam 100.000 token'dır. İstek başına maksimum çıktı 32.000 token'dır (max_tokens ayarlanmamışsa 2.048). Bağlam penceresini aşarsanız istek başarısız olur. Hatalar arasında geçersiz anahtarlar için 401, yetersiz kredi için 402 ve hız limitleri için 429 bulunur. Hız limiti dakikada 300 istek ve anahtar başına 8 eşzamanlı istektir. İstek gövdeleri 8 MB ile sınırlıdır. Hatalar ücretsizdir, bu nedenle başarısız istekler veya reddedilenler için ödeme yapmazsınız. Kredi hiç sona ermez ve abonelik gerekmez.