Kimicode: İlk istek beş dakikada

Temel URL ve Kimlik Doğrulama

İstemcinizi temel URL'mize yönlerek başlayın: https://api.kimicode.top/v1. Her istek için bir API anahtarına ihtiyacınız vardır. Sitede API anahtarını al'e tıklayarak bir tane oluşturun. Google ile giriş yapın veya e-posta ve şifre kullanın. Telefon numarası gerekmez. Anahtar oluşturulduktan hemen sonra gösterilir. Güvende tutun; hesabınızda tek bir aktif anahtar bulunur. Yeni bir anahtar oluşturursanız, eski anahtar çalışmayı bırakır. Anahtarı Authorization başlığında bearer token olarak iletin.

İlk İstek

İlk isteminizi sohbet tamamlamaları uç noktasına gönderin. uncensored model kimliğini kullanın. API standart OpenAI uyumlu formatları kabul eder. Girdi girilir, metin çıkar. Hatalar ve reddetmeler ücretsizdir, bu nedenle yalnızca başarılı token kullanımından ödersiniz. Bağlantıyı basit bir istemle test edin.

Kopyalacurl https://api.kimicode.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."}]
  }'

Anahtar geçersizse 401 hatası alırsınız. Krediniz yoksa 402 alırsınız. Beklenmedik istek hataları durumunda hesap bakiyenizi kontrol edin.

Python SDK Entegrasyonu

Resmi OpenAI Python SDK'sını kullanın. Temel URL'yi uç noktamıza ayarlayın. API anahtarınızı iletin. İstemci istek formatını otomatik olarak yönetir. Bu, OpenAI uyumlu istemcileri destekleyen herhangi bir dil için çalışır. Kütüphaneyi pip aracılığıyla yükleyin. İstemcinizi temel URL ve anahtarınızla yapılandırın. Sohbet tamamlamaları uç noktasını kullanarak bir mesaj gönderin. Yanıt oluşturulan metni içerir. İçeriği yanıt nesnesinden doğrudan ayrıştırabilirsiniz.

Kopyalafrom openai import OpenAI

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

Kodunuzun istisnaları zarif bir şekilde ele aldığından emin olun. Ağ sorunları veya hız limitleri yeniden denemeler gerektirebilir.

Node SDK Kullanımı

Node.js SDK aynı şekilde çalışır. İstemciyi içe aktarın. Temel URL'yi ve API anahtarını yapılandırın. Sohbet tamamlama uç noktasını çağırın. Model kimliğini ve mesaj dizisini iletin. Yanıt yapısı OpenAI formatıyla eşleşir. Asistan mesajı içeriğini ayıklayın. Bu yaklaşım sunucu tarafı oluşturucu işlevler veya kenar işlevler için çalışır. Temel URL değişikliğinden başka ek yapılandırma gerekmez.

Kopyalaimport OpenAI from "openai";

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

Durum kodunu kontrol ederek hataları yönetin. Hız limitleri 429 döndürür. Yetersiz bakiye 402 döndürür.

Akış Yanıtları

stream: true ayarlayarak akışı etkinleştirin. API Server-Sent Events (SSE) döndürür. Her parça kısmi içerik içerir. Token kullanım ayrıntıları son parçada görünür. Bu, uzun çıktılar için algılanan gecikmeyi azaltır. Akış sonlandırmasını düzgün şekilde işleyin. Akış bittiğinde veya bir hata oluştuğunda bağlantıyı kapatın. Akış, SSE'yi destekleyen tüm standart istemcilerle çalışır.

Kopyalastream = 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)

İstemcinizin parçaları doğru şekilde arabelleğe aldığınından emin olun. Son yanıtı oluşturmak için içeriği birleştirin.

Limitler, Hatalar ve Bağlam

Bağlam penceresi toplam 100.000 token'dır. Maksimum çıktı, istek başına 32.000 token'dır. max_tokens ayarlanmamışsa 2.048 olarak ayarlayın. Hız limiti, anahtar başına dakikada 300 istektir. Eşzamanlılık limiti dakikada 8 eşzamanlı istektir. İstek gövdesi maksimum 8 MB'tır. Hatalar arasında geçersiz anahtarlar için 401, kredi yok için 402 ve hız limitleri için 429 bulunur. Kredi hiçbir zaman sona ermez. Hatalar ücretsizdir. Abonelik tuzağı yoktur.