API Dokümantasyonu: Hızlı Başlangıç

Base URL ve Kimlik Doğrulama

sunucusuz LLM API'si standart OpenAI uyumlu uç nokta yapısını kullanır. Başlamak için iki bilgiye ihtiyacınız vardır: base URL ve API anahtarınız.

Tüm istekler için aşağıdaki base URL'i kullanın:

https://api.serverlessllmapi.com/v1

Kimlik doğrulama Authorization başlığı aracılığıyla yapılır. Anahtarınızı almak için Get API key sayfasında bir hesap oluşturun. Bu anahtarı istediğiniz zaman yenileyebilirsiniz; bu işlem eski anahtarı hemen geçersiz kılar. Anahtarınızı güvenli tutun, çünkü ön ödemeli kredilerinize doğrudan erişim sağlar.

İlk İstek: Sohbet Tamamlamaları

/v1/chat/completions uç noktasına standart bir sohbet tamamlama isteği gönderin. API bir model adı, bir mesaj listesi ve isteğe bağlı parametreler kabul eder. Varsayılan model ID'miz uncensored olup yüksek kaliteli, kısıtlamasız yanıtlar için optimize edilmiştir.

Bir yanıt oluşturmak için curl kullanarak temel bir örnek:

Copycurl https://api.serverlessllmapi.com/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."}]
  }'

Yanıt, standart OpenAI JSON formatını izler. İstek başarılı olursa, oluşturulan metni içeren bir tamamlama nesnesi alırsınız. Bu sadelik, base URL ve API anahtarını değiştirerek uç noktamızı mevcut OpenAI SDK yapılandırmalarına entegre etmenizi sağlar.

Python SDK Entegrasyonu

Resmi OpenAI Python SDK'sını kullanmak entegrasyonun en hızlı yoludur. API'miz OpenAI uyumlu bir API olduğundan, yalnızca base URL ve API anahtarı değerlerini geçmeniz yeterlidir. Bu sayede mevcut kodunuzda değişiklik yapmadan çalışmaya devam eder.

Copyfrom openai import OpenAI

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

Bu yaklaşım, tanıdık Python kütüphanelerinden yararlanmanızı ve sansürsüz modelimizden faydalanmanızı sağlar. Bağlam penceresi tek bir istek içinde önemli giriş ve çıkış uzunlukları için 100.000 token'a kadar destekler. Modeli etkili bir şekilde yönlendirmek için mesaj dizinizin gerekli sistem ve kullanıcı istemlerini içerdiğinden emin olun.

Node.js SDK Entegrasyonu

JavaScript ve TypeScript geliştiricileri için OpenAI Node SDK'sı, basit bir entegrasyon yolu sağlar. İstemciyi base URL ve API anahtarınızla yapılandırarak istek yapmaya hemen başlayabilirsiniz.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.serverlessllmapi.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 kurulum, gerçek zamanlı LLM etkileşimleri gerektiren sunucusuz işlevler veya arka uç hizmetleri için idealdir. Kullanım bazlı fiyatlandırma sayesinde yalnızca kullandığınız şey için ödeme yaparsınız, aylık abonelik yoktur. Krediler süresi dolmaz, bu nedenle projeler arasında kullanımı duraklatabilir ve bakiyenizi kaybetmezsiniz.

Akışlı Yanıtlar (SSE)

İsteğinizde stream: true ayarını yaparak akış özelliğini etkinleştirin. API, tokenlar oluşturulurken görüntülemenizi sağlayan bir Server-Sent Events (SSE) akışı döndürür. Bu, son kullanıcılar için algılanan gecikmeyi azaltır ve sohbet uygulamaları için deneyimi iyileştirir.

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 yanıtı biriktirmek için istemci kodunuzda akış olaylarını işleyin. Akış, doğru yapılandırıldığında hem Python hem de Node SDK'ları ile çalışır. Bu özellik, anında geri bildirim değerli olan uzun formatlı içerik oluşturma için özellikle yararlıdır.

Hız Limitleri ve Kısıtlamalar

Sorunsuz entegrasyon için kısıtlamaları anlayın. API, API anahtarı başına dakikada 300 istek hız limiti uygular. Her istek gövdesi 8 MB'ı aşmamalıdır. Hız limitini aşarsanız 429 durum kodu alırsınız.

Kimlik doğrulama hataları 401 durumunu döndürür; bu geçersiz veya iptal edilmiş bir anahtara işaret eder. Ön ödemeli krediniz tükendiğinde, istekler 402 durumunu döndürür. uncensored model ID'si gömme (embedding), görüntü oluşturma veya ince ayarı desteklemez. Optimal performans için metin tabanlı sohbet tamamlamalarına bağlı kalın.