Temel URL ve Kimlik Doğrulama
Sağlanan temel URL ve ön ödemeli token anahtarı ile API'ye bağlanın. API anahtarınızı istek başlığında ileterek kimlik doğrulaması yapın; bu sayede yalnızca hesabınız kredilerine erişebilir. Google veya e-posta ile kaydolun ve telefon doğrulaması olmadan anahtarınızı hemen edinin.
curl https://api.kimicodeapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "What is the current rate limit for free tier users?"}]
}'İstekleriniz standart OpenAI-uyumlu uç noktasını hedefler. Bu tasarım, temel URL'yi ve kimlik bilgilerini güncellemeniz koşuluyla mevcut istemci kodunuzu yeniden yazmadan hizmetimizi değiştirmenizi sağlar.
Sohbet Tamamlamaları Uç Noktası
Mesajları şu modeli kullanarak gönderin POST /v1/chat/completions endpoint. Model kimliğini uncensored sunucularımızda çalışan optimize edilmiş büyük dil modeline erişim. Sistem, çok dönüşlü konuşmalar için kullanıcı veya asistan gibi standart mesaj rollerini kabul eder.
from openai import OpenAI
client = OpenAI(base_url="https://api.kimicodeapi.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 uç nokta meti girdisini kabul eder ve üretilen meti döndürür. Embeddingleri, resimleri veya sesi desteklemez. En iyi sonuçları almak için prompt yapınıza odaklanın.
Akış Yanıtları (SSE)
İsteğinizde stream parametresini true olarak ayarlayarak gerçek zamanlı token teslimatını etkinleştirin. API, uygulamanızın metni oluşturulurken görüntülemesini sağlayan Sunucu Tarafı Olayları (SSE) parçalarını döndürür. Son parça, faturalandırma için tam token kullanım istatistiklerini içerir.
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)Akış, son kullanıcılar için algılanan gecikmeyi azaltır. Her belirteci geldiği gibi işleyebilirsiniz, bu sohbet arayüzleri için idealdir. Akışın, temel model davranışını veya belirteç fiyatlandırmasını değiştirmediğini unutmayın.
Fonksiyon Çağırma ve Araçlar
Modelin yapılandırılmış işlev çağrıları üretmesini sağlamak için istek gövnenize araçlar tanımlayın. API, modelin belirli bir aracı zorlamasına veya otonom karar vermesine olanak tanıyan tool_choice parametrelerini destekler. Bu özellik, standart OpenAI araç formatlarıyla çalışır, bu da entegrasyonu kolaylaştırır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimicodeapi.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);Uygulamalarınızda veri çıkarmak veya eylemleri tetiklemek için fonksiyon çağrısı kullanın. Model araç tanımlarını yorumlar ve gerekli argümanları içeren JSON nesneleri döndürür. Bu yetenek API'yi basit metin üretiminin ötesine taşır.
JSON Modu ve Parametreler
Yüksek doğruluk için response_format parametresini kullanarak sıkı JSON çıktısı zorunlu kılın. response_format için {"type": "json_object"}. Bu, modelin programatik ayrıştırma için kritik olan geçerli JSON döndürmesini sağlar. Yaratıcılığı ve çıktı uzunluğunu kontrol etmek için sıcaklık, top_p ve durdurma dizileri gibi parametreleri ayarlayabilirsiniz.
Model 100.000 token'lık bir bağlam penceresi destekler. Bu, tek bir istekte büyük miktarda bağlam iletmenizi sağlar. Maksimum çıktı istek başına 16.000 token'dır veya max_tokens belirtmezseniz 2.048'dir.
Limitler, Hatalar ve Bağlam
Hizmet kesintilerini önlemek için istek limitlerinizi izleyin. API anahtar başına dakikada 300 istek ve 8 eşzamanlı istek izni verir. İstek gövdeniz 8 MB'ın altında kalmalıdır. Bu limitleri aşarsanız 429 hız sınırı hatası alırsınız.
Kimlik doğrulama hataları anahtar geçersizse 401 hatası döndürür. 402 hatası yetersiz ön ödemeli kredi olduğunu gösterir. Oluşturma sırasında oluşan hatalar tokenlarınızı tüketmez. Bağlam penceresi hem istem hem de tamamlama tokenlarını içerir. Kullanılmayan kredi asla süresi dolmaz, böylece ön ödemeli bakiyeniz gelecekteki projeler için kullanılabilir kalır.