kimiapikey.comDokümantasyon
Kimi API: İlk istek beş dakikada
Standart OpenAI uyumlu arayüz kullanarak beş dakikadan kısa sürede ilk yanıtınızı alın. Bu kılavuz, sansürsüz model için kurulumu, kimlik doğrulamayı ve temel kullanımı kapsar.
Önkoşullar
Başlamak için kimiapikey.com'den bir API anahtarına ihtiyacınız var. Deneme için yalnızca e-posta ve şifre ile kaydolun; kredi kartı gerekmez. Resmi veya uyumlu bir SDK yüklü olan desteklenen bir dil ortamına da ihtiyacınız vardır. API'miz OpenAI chat-completions formatını takip ettiği için GPT-3.5/4 için mevcut kodlar genellikle minimum değişikliklerle çalışır. SDK sürümünüzün base_url parametresini destekleyecek kadar güncel olduğundan emin olun.
Temel URL ve Kimlik Doğrulama
API'miz https://api.kimiapikey.com/v1 adresinde çalışır. Kimlik doğrulama standart Authorization başlığı aracılığıyla yapılır. Anahtarınızı Bearer token olarak iletin. Bu, OpenAI uyumlu uç nokta kabul eden herhangi bir istemciyle çalışır. Bir proxy veya özel istemci kullanıyorsanız, Authorization başlığının doğru şekilde iletildiğinden emin olun. İsteyeceğiniz model kimliği uncensored olacaktır.
İlk İstek
Kurulumunuzu doğrulamak için basit bir sohbet tamamlama isteği gönderin. Aşağıdaki curl komutunu kullanın ve YOUR_API_KEY yerine gerçek anahtarınızı yazın. Bu istek, uncensored modeline kısa bir istem gönderir. Başarılı olursa, modelin yanıtını içeren bir JSON yanlı alırsınız. Oluşturulan metni choices dizisinde kontrol edin. 401 hatası alırsanız anahtarınız geçersiz veya süresi dolmuş demektir.
Python SDK
En kolay entegrasyon için resmi OpenAI Python kütüphanesini kullanın. base_url değerini uç noktamıza ayarlayın ve anahtarınızı sağlayın. Bu örnek temel bir metin oluşturma çağrısını gösterir. Gerekirse model parametresini ayarlayabilirsiniz, ancak varsayılan değer uncensored'dir. Bu yaklaşım, kodunuzu farklı OpenAI uyumlu hizmetler arasında taşınabilir kılar.
Node SDK
JavaScript/TypeScript projeleri için openai npm paketini kullanın. İstemciyi temel URL'miz ve API anahtarınızla yapılandırın. Bu, Node ortamınızdan doğrudan istek yapmanızı sağlar. Sözdizimi Python SDK'yı yansıtır, böylece dil değiştirirseniz tutarlılık sağlanır. await kullanarak asenkron yanıtları doğru şekilde işlemeyi unutmayın.
Akış Yanıtları
Gerçek zamanlı çıktı için SDK'nızda akışı etkinleştirin. Bu, metin parçaları oluşturuldukça gönderilerek algılanan gecikmeyi azaltır. İsteğinizde stream bayrağını kullanın. SDK kısmi yanıtlar sağlayarak UI'nın kademeli olarak güncellenmesine olanak tanır. Bu, anında geri bildirim değerli olan sohbet arayüzleri veya uzun formatlı içerik oluşturma için idealdir.
Limitler ve Hatalar
Her anahtar dakika başına 300 istekle sınırlıdır. Bu sınırı aşarsanız 429 hatası alırsınız. İstek gövmeniz 8 MB'ı geçmemelidir. 100.000 token'lık bağlam penceresi, istem ve tamamlama toplamına uygulanır. Yaygın hatalar arasında 401 (geçersiz anahtar) ve 402 (yetersiz kredi) yer alır. API'yi kullanmaya devam etmek için panelden bakiye yükleyin. Krediler asla sona ermez ve aylık ücret yoktur.
cURL
curl https://api.kimiapikey.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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.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);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)Sorular ve cevaplar
API fonksiyon çağırma'yı destekliyor mu?
Evet, uç nokta standart OpenAI formatında tool/fonksiyon çağırma'yı destekler. İsteğinizde araçları tanımlayabilir ve model yapılandırılmış argümanlar döndürür.
Hız limitini aşarsam ne olur?
429 Too Many Requests hatı alırsınız. Kısa bir süre bekleyip yeniden deneyin veya daha yüksek aktarım hızını sürdürmek için ön ödemeli kredi seviyenizi yükseltin.
Model, verilerim üzerinde eğitilmiş mi?
Hayır. API'ye gönderilen istemler eğitim için kullanılmaz. Verileriniz gizli kalır ve temel modelin iyileştirilmesinde kullanılmaz.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulum bu kadar basit.
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 |
| Model kimliği | uncensored |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Parametreler | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 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 |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| JSON modu | response_format: {"type": "json_object"} |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| 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 |
| İstek boyutu | en fazla 8 MB |
| Fiyat | 1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50 |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15 |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Yükleme | USDT (TRC20) veya USDC (Base), $20–$500 arası herhangi bir tam tutar |
| Ü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) |
| Anahtarlar | hesap başına bir aktif anahtar; yenisi eskisinin yerini alır |
| Giriş | Google veya e-posta ve şifre |
| İç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 |