Temel URL ve Kimlik Doğrulama
API'miz şurada bulunur: https://api.huggingfacellmapi.com/v1. Bearer token'ı kullanarak kimlik doğrulaması yaparsınız Authorization header Anahtarınızı API anahtarı al Google veya e-posta ile giriş yapın. Bu anahtarı güvende tutun; bu anahtara sahip olan herkes ön ödemeli kredilerinizi harcayabilir. Kaybederseniz, eski aktif anahtarı değiştirmek için yeni bir tane oluşturun. Başlamak için telefon numarası gerekmez.
İlk İstek (cURL ile)
Uç noktasını hemen test etmek için ham bir JSON yükü gönderin. Model kimliğini kullanın uncensored standart filtreleri aşmak için. Aşağıdaki cURL komutu temel bir metin üretme isteğini gösterir.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'Bu, oluşturulan metni içeren bir JSON nesnesi döndürür. Şunu kontrol edin choices gerçek içerik için dizi. 401 hatası alırsanız anahtarınızın doğru ve aktif olduğunu doğrulayın.
Python SDK Entegrasyonu
Resmi openai Temiz bir arayüz için Python kütüphanesi. İstemciyi temel URL'mize yönlendirin ve API anahtarınızı ayarlayın. Bu yaklaşım, yeniden denemeleri ve JSON ayrıştırmayı otomatik olarak yönetir.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)Paketi pip aracılığıyla yükleyin. Ardından, OpenAI ile yapacağınız gibi sohbet tamamlama uç noktasını çağırabilirsiniz. Yanıt nesnesi, token kullanımına ve bitiş nedenlerine erişim sağlar.
Node.js İstemci Kurulumu
JavaScript developers can use the openai Node paketi. İstemciyi özel temel URL'mizle yapılandırın. Bu, tüm isteklerin sansürsüz sunucularımız üzerinden yönlendirilmesini sağlar.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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);Bu kod parçasını Node ortamınızda çalıştırın. Basit bir eşzamanlı çağrıyı gösterir. Bu kodu Express rotalarına veya sunucusuz işlevlere kolayca entegre edebilirsiniz.
Akış Yanıtları
Ayarlayarak akışı etkinleştirin stream: true. Sunucu, her oluşturulan token için kısmi tokenlar içeren Sunucu Tarafından Gönderilen Olaylar (SSE) gönderir. Bu, son kullanıcı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)Her parçayı geldiği gibi ayrıştırın. Son parça, istek için toplam token kullanımını içerir. Bu, yanıtları gerçek zamanlı olarak yazan sohbet arayüzleri oluşturmak için kullanışlıdır.
Limitler, Hatalar ve Bağlam
Bağlam penceresi, istem ve tamamlama birlikte 100.000 token'dır. 16.000 çıktı tokenına kadar talep edebilirsiniz. 401 hataları geçersiz bir anahtarı, 402 ise yetersiz krediyi gösterir. Hız sınırları sizi dakikada 300 istekle sınırlar. Boyutu 8 MB'ı aşan istekler reddedilir. İşleme sırasında oluşan hatalar kredilerinizi tüketmez.