İlk istek beş dakika içinde
Kimi API anahtarınızı herhangi bir OpenAI uyumlu istemciye yerleştirin ve sansürsüz metin üretmeye başlayın. Bu kılavuz, SDK'nızı nasıl yapılandıracağınızı ve gerçek token fiyatlandırmasını anlamanızı sağlar.
OpenAI Python/Node SDK'sını Yükleyin
Standart OpenAI istemci kitaplığını yükleyerek başlayın. Bu, API'nizin aynı OpenAI uyumlu arayüzü izlemesi sayesinde çalışır. Özel bir SDK'ya ihtiyacınız yok. Python için pip install openai veya Node.js için npm install openai çalıştırın. Kitaplık JSON serileştirmesini ve HTTP isteklerini otomatik olarak halleder.
Temel URL ve API Anahtarını Yapılandırın
İstemcinizi uç noktamıza yönlendirin. Temel URL'yi https://api.kimiapi.top/v1 olarak ayarlayın ve panodan API anahtarınızı sağlayın. Bu anahtar ön ödemeli kredinizi doğrular. Kayıt sayfasında Google veya e-posta ile anında yeni bir anahtar oluşturabilirsiniz. Başlamak için kredi kartı gerekmez.
curl https://api.kimiapi.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."}]
}'
İlk Sohbet Tamamlama İsteğini Gönderin
uncensored modeline basit bir mesaj gönderin. Bu model, yasal yetişkin kullanım için reddetmeden yanıt verecek şekilde ayarlanmıştır. 100.000 token'lık bir bağlam penceresini destekler, ancak maksimum çıktı 32.000 token'dır. Yanıt doğrudan metin olarak döner. Hatalar ve reddetmeler kredinizi tüketmez.
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.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)
SSE ile Akışı Etkinleştirin
Gerçek zamanlı yanıtlar için akışı etkinleştirin. SDK, tokenları Sunucu Tarafı Olayları (SSE) aracılığıyla aktarır. Son parça, faturalandırma için toplam token kullanımını içerir. Bu yaklaşım, uzun çıktılar için algılanan gecikmeyi azaltır. Tokenları uygulama mantığınızda geldikçe işleyebilirsiniz.
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)
Yapılandırılmış Çıktı İçin JSON Modunu Kullanın
response_format değerini {"type": "json_object"} olarak ayarlayarak tutarlı makine tarafından okunabilir çıktı sağlayın. Bu, modelin geçerli JSON döndürmesini sağlar. Veri çıkarma veya yapılandırma oluşturma için idealdir. Model yapıyı bozmaz, bu da kodunuzdaki yanıtları ayrıştırmayı kolaylaştırır.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.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);
Kullanım ve Maliyetleri Kontrol Edin
Kullanımınızı panodan izleyin. Giriş maliyetleri milyon token başına $0,25; çıktı milyon başına $1,00'dır. 401 alırsanız anahtarınızı kontrol edin. 402, USDT veya USDC ile bakiye yüklemeniz gerektiğini gösterir. 429, dakikada 300 istek sınırına ulaştığınızı belirtir. Kredi süresi dolmaz, bu yüzden uygun olduğunda bakiye yükleyin.
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.top/v1 |
| Uç noktalar | POST /v1/chat/completions · GET /v1/models |
| Kimlik doğrulama | Authorization: Bearer YOUR_KEY |
| Model kimliği | uncensored |
| Bağlam penceresi | 100.000 token (girdi + çıktı) |
| JSON modu | response_format: {"type": "json_object"} |
| Maksimum çıktı | 100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok) |
| Akış | evet — server-sent events; son parça token kullanımını içerir |
| 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 |
| Hız limiti | anahtar başına dakikada 300 istek |
| Eşzamanlılık | anahtar başına aynı anda 8 istek |
| İstek boyutu | en fazla 8 MB |
| Yanıt başlıkları | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Faturalama | ön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz |
| Geçerlilik | ödenen kredinin süresi dolmaz, abonelik yok |
| Fiyat | 1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00 |
| Yükleme | USDT (TRC20) veya USDC (Base), $10–$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) |
| Bonus | $50'dan itibaren +%5, $100'dan itibaren +%10 |
| 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
Kimi API'si için faturalandırma nasıl çalışır?
Sadece gerçek token kullanımına ödeme yaparsınız. Giriş tokenları milyon başına $0,25, çıktı tokenları milyon başına $1,00'dır. Hatalar ve reddetmeler ücretsizdir. Kredi ön ödemelidir ve süresi dolmaz.
Hangi kripto para ödemeleri kabul edilir?
USDT (TRC20) ve USDC (Base) kabul ediyoruz. Bakiye yükleme $10 ile $500 arasındadır. Ödemeler kart veya PayPal olmadan doğrudan işlenir.
Bağlam penceresi sınırı nedir?
Model, hem istem hem de tamamlama için 100.000 tokenlık bağlam penceresini destekler. Ancak, daha düşük bir sınır belirtmedikçe istek başına maksimum çıktı 32.000 tokendır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadardır.