API Dokümantasyonu - KimiCode

Temel URL ve Kimlik Doğrulama

Kodunuzu temel URL'yi güncelleyerek ve anahtarınızı başlıkta sağlayarak API'mize bağlayın. Standart kimlik doğrulamayı destekliyoruz, bu nedenle mevcut OpenAI SDK istemcileri karmaşık kurulum olmadan hemen çalışır. API anahtarınız Google veya e-posta ile kaydolduktan sonra anında görünür, telefon numarası gerekmez.

Her hesapta aynı anda tek bir aktif anahtar bulunur; yeni anahtar oluşturmak eskisinin yerini alır. İstekler, ön ödemeli kredinize güvenli erişimi sağlayan Authorization başlığı aracılığıyla doğrulanır.

İlk İstek

Basit bir POST isteği kullanarak standart sohbet tamamlama uç noktasını kullanarak ilk mesajınızı gönderin. Bu, gelişmiş özelliklere veya akış verilerine başlamadan önce entegrasyonunuzun çalıştığını doğrular. Yanıt, uncensored modelden metin çıktısını döndürür.

• YOUR_API_KEY'i panodan aldığınız anahtarla değiştirin.
• Modeli 'uncensored' olarak ayarlayın, özel açık ağırlıklı modelimiz için.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

Python SDK Entegrasyonu

API'mizle etkileşim kurmak için resmi OpenAI Python kütüphanesini kullanarak base URL'imize işaret edin. Bu yaklaşım, tanıdık sözdiziminden yararlanır ve tüm uygulama mantığını yeniden yazmadan sağlayıcı değiştirmenize olanak tanır. SDK, tokenizasyonu ve istek biçimlendirmesini otomatik olarak halleder.

• openai paketini pip aracılığıyla yükleyin.
• Temel URL'yi hizmetimize işaret edecek şekilde yapılandırın.

Copyfrom openai import OpenAI

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

Node SDK Entegrasyonu

API'mizi JavaScript veya TypeScript uygulamalarınıza Node SDK'sı aracılığıyla entegre edin. Bu, ön uç ve arka uç ortamlarınızda tutarlı davranış sağlar. Mesajları iletebilir ve herhangi bir standart OpenAI uyumlu serviste yapacağınız gibi yanıtlar alabilirsiniz.

Copyimport OpenAI from "openai";

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

Streaming ve Token Kullanımı

Sunucu Tarafından Gönderilen Etkinlikler (SSE) üzerinden gerçek zamanlı token üretimi almak için akış özelliğini etkinleştirin. Bu, kullanıcılar için algılanan gecikmeyi azaltır ve kısmi sonuçların anında görüntülenmesine olanak tanır. Giriş ve çıkış sayıları dahil olmak üzere token kullanım verileri, akışın son parçasına gömülüdür.

Bu yöntem, anlık geri bildirimin önemli olduğu sohbet arayüzleri için idealdir. Tüm yanıt beklemek yerine, UI'yi kademeli olarak güncellemek için akışı ayrıştırabilirsiniz.

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)

Limitler, Hatalar ve Bağlam

Kullanımınızı hız sınırlarını ve yaygın hata kodlarını anlayarak yönetin. API, 100,000 token'lık bir bağlam penceresi destekler ve derin konuşma geçmişine olanak tanır. Dakikada 300 istek ve anahtar başına 8 eşzamanlı istekle sınırlısınız.

• 401 geçersiz veya eksik bir API anahtarı olduğunu gösterir.
• 402 ön ödemeli kredinizin tükendiğini işaret eder.
• 429 hız sınırını aştığınızı gösterir.

Hatalar kredinizi tüketmez, bu nedenle başarısız istekleri ceza ödemeden yeniden deneyebilirsiniz.