Kimi kullanıcıları için hızlı başlangıç
Mevcut OpenAI SDK çağrılarınızı sansürsüz bir LLM'e yönlendirmek için yeni bir temel URL ve API anahtarı ekleyin. Bu kılavuz, sohbet etmeye, akış yapmaya ve araçları kullanmaya başlamak için gereken tam üç satırı gösterir.
Önkoşullar: API Anahtarı
İstek göndermeden önce bir API anahtarına ihtiyacınız var. API anahtarı al sayfasında Google ile devam veya e-posta ve şifre kullanarak kaydolun. Anahtarınız hemen görünür. Yeni hesaplar 7 gün geçerli $0,50 deneme kredisi alır; kart gerekmez. Ödemeli kullanım için USDT (TRC20) veya USDC (Base) ile bakiye yükleyin. Yüklemeler 10 $ ile 500 $ arasındadır. 50 $ veya daha fazla yükleme için +%5 bonus, 100 $ veya daha fazla için +%10 bonus alırsınız. Kredi süresi dolmaz ve yalnızca gerçek token kullanımı için ücretlendirilir. Hatalar ve reddetmeler ücretsizdir. Hesap başına bir aktif anahtar tutabilirsiniz; yeni anahtar oluşturmak eskisini değiştirir. Bu anahtarı tüm isteklerdeAuthorization başlığında kullanın.
Temel Sohbet Tamamlama
kimi api uç noktası, standart OpenAI sohbet-tamamlama isteklerini kabul eder. İstemcinizin temel URL'sini https://api.kimiapi.cc/v1 olarak ayarlayın ve anahtarınızı sağlayın. Tek bir, özel sansürsüz modeli sunuyoruz; model kimliği uncensored olarak belirtilmiştir. Bu model açık ağırlıklıdır, sunucularımızda çalışır ve yasal yetişkin, kurgusal veya tartışmalı konularda reddetmez. GPT, Claude, Gemini veya başka bir satıcının modeli değildir. İstem gönderebilir ve metin yanıtları alabilirsiniz. Model, 100.000 token'lık bir bağlam penceresini (istem + tamamlama) destekler. Her istek için maksimum çıktı 32.000 token'dır; max_tokens ayarlanmazsa bu değer 2.048 token olur. Embedding, görüntü veya ses oluşturulmaz.
Akışlı Yanıtlar
Akış için Sunucu Tarafından Gönderilen Olayları (SSE) kullanın. API, tokenlar oluşturuldukça akış yapar. Token kullanım bilgisi akışın son parçasında dahil edilir. Bu, tam yanıtı beklemeden maliyetleri gerçek zamanlı izlemenizi sağlar. Akış, tüm standart OpenAI uyumlu SDK'lar tarafından desteklenir. İsteğinizestream=true ayarlayın. İstemci, metni içeren bir dizi delta nesnesi alacaktır. Bu delta'ları birleştirerek tam yanıtı yeniden oluşturabilirsiniz. Bu, kullanıcıların anında geri bildirim beklediği sohbet arayüzleri için idealdir. kimi api, proxy yükünden kaçınarak öngörülebilir gecikme süresi sağlar.
Fonksiyon Çağırma (Araçlar)
API, fonksiyon çağırma (araçlar olarak da bilinir) destekler. İsteğinizde araçlar tanımlayabilir ve model uygun olduğunda yapılandırılmış argümanlar döndürebilir. Araç tanımlarının bir listesini geçmek içintools parametresini kullanın. Araçları zorlamak veya otomatik seçmek için tool_choice de kullanabilirsiniz. Model, konuşmaya devam etmek için API'ye geri gönderebileceğiniz bir araç çağrıları içeren bir yanıt döndürür. Bu, ajanlar veya otomatik iş akışları oluşturmayı sağlar. Araç tanımları standart OpenAI formatını izler. Sansürsüz model, araç tanımlarını geçerli kullanım durumları için kullanmaktan kaçınmadan doğru şekilde işler. Daha sıkı çıktı biçimlendirme için JSON modu da mevcuttur.
JSON Modu
Sıkı çıktı gerektiren uygulamalar için JSON modunu kullanın.response_format değerini {"type": "json_object"} olarak ayarlayın. Model geçerli bir JSON nesnesi döndürmeye çalışacaktır. Bu, veri ayrıştırma, yapılandırma dosyası oluşturma veya yapılandırılmış verileri diğer sistemlere besleme için kullanışlıdır. JSON modu fonksiyon çağırma ile birlikte çalışır. Yaratıcılığı ve determinizmi kontrol etmek için temperature, top_p, stop, seed, presence_penalty ve frequency_penalty gibi parametreleri de ayarlayabilirsiniz. Bu parametreler OpenAI uyumlu istemciler için standarttır. Kullanım durumunuza bağlı olarak tutarlılık ve yaratıcılık arasında denge kurmak için bunları ayarlayın.
Limitler, Hatalar ve Bağlam
Her API anahtarı dakikada 300 istek ve 8 eşzamanlı istekle sınırlıdır. İstek gövdesi 8 MB'ı geçmemelidir. Anahtar geçersizse 401 hatası alırsınız. Krediniz yoksa 402 hatası alırsınız. Hız limitini aşarsanız 429 hatası alırsınız. Hatalar ve reddetmeler ücretsizdir, bu nedenle başarısız istekler için ücretlendirilmezsiniz. Bağlam penceresi toplam 100.000 token'dır. Katı bir içerik sınırı geçerlidir: reşit olmayanlarla ilgili cinsel içerik içeren istekler her zaman reddedilir. API yalnızca metin desteği sunar. Gömme (embedding), görüntü veya ince ayar (fine-tuning) mevcut değildir. Diğer sağlayıcıların modelleri için mevcut fiyatları ve limitleri görmek için onların dokümantasyonuna bakın. Bu hizmet bağımsız bir alternatiftir ve onlarla bağlantılı değildir.
cURL
curl https://api.kimiapi.cc/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.cc/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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.cc/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);Akış
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)Teknik özellikler
Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.
| Öğe | Değer |
|---|---|
| Biçim | OpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır |
| Base URL | https://api.kimiapi.cc/v1 |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| JSON modu | response_format: {"type": "json_object"} |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| Fonksiyon çağırma | evet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| İstek boyutu | en fazla 8 MB |
| Hız limiti | anahtar başına dakikada 300 istek |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| Ücretsiz deneme | $0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300) |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Giriş | Google veya e-posta ve şifre |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| İçerik | yetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir |
Hata kodları
Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.
| Kod | Tür | Anlamı |
|---|---|---|
400 | bad_request | geçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun |
401 | missing_key · invalid_key · key_revoked | anahtar yok, yanlış veya değiştirilmiş |
402 | no_credit | kredi bitti — yükleyin, hemen devam eder |
403 | content_blocked | reşit olmayanları içeren cinsel içerik — reddedildi, ücret yok |
404 | not_found | bilinmeyen uç nokta |
413 | request_too_large | gövde 8 MB'tan büyük |
429 | rate_limited · concurrency | dakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin |
503 | upstream_busy | model meşgul — birkaç saniye sonra tekrar deneyin |
Sorular ve cevaplar
Bağlam penceresi ve çıktı limiti nedir?
Bağlam penceresi, istem ve tamamlama birlikte 100.000 token'dır. Her istek için maksimum çıktı 32.000 token'dır. <code>max_tokens</code> ayarlamazsanız, limit 2.048 token'dır.
Kredimi nasıl yüklerim?
Yalnızca kripto ile bakiye yükleyin: USDT (TRC20) veya USDC (Base). Kabul edilen tutarlar 10 $ ile 500 $ arasında tam dolarlardır. 50 $ veya daha fazla yükleme için +%5 bonus, 100 $ veya daha fazla için +%10 bonus alırsınız. Kredi süresi dolmaz.
Bu resmi Kimi API'si mi?
Hayır. Bu, OpenAI uyumlu bir uç nokta sağlayan bağımsız bir hizmettir. Tek bir sansürsüz modeli sunuyoruz. Moonshot AI veya başka herhangi bir satıcı ile bağlantımız yoktur. Resmi API'leri için ilgili satıcı dokümantasyonunu kontrol edin.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadar.