kimiapikey.comKılavuz
Moonshot API Base URL: Kodunuzu Başka Yere Yönlendirin
Moonshot API base URL, OpenAI tarzı istemcinizdeki tek bir dizgedir ve onu değiştirmek, aynı kodu farklı bir sağlayıcıya yönlendirmenin yoludur. Bu sayfa, bu dizgenin Python, Node.js, curl ve yaygın araçlarda nerede bulunduğunu ve alternatif bir uç noktaya nasıl yönlendirileceğini gösterir.
güncellendi


Temel noktalar
- Base URL tek bir ayardır; istek gövdesi OpenAI chat formatında kalır.
- Geçiş yaparken üç şeyi değiştirin: base URL, API anahtarı, model ID.
- Uç noktamız https://api.kimiapikey.com/v1 ve model ID'si uncensored'dır.
- Bağımsız bir barındırılan modeldir, Moonshot'un resmi hizmeti değildir, bu yüzden istemlerinizi yeniden test edin.
Base URL'ın aslında ne yaptığı
OpenAI-uyumlu istemciler her isteği iki parçadan oluşturur: bir base URL ve bir yol. SDK bunları birleştirir, bu nedenle chat.completions.create çağrısı, <base_url>/chat/completions adresine bir POST isteğine dönüşür. Bu formatı takip eden sağlayıcılar (Moonshot dahil) kendi base URL'larını belgelerinde yayınlar. Bir forum gönderisinden kopyalamak yerine oradan bakın, çünkü bu tahmin edilemeyen tek değerdir.
Sağlayıcı değiştirmek bu nedenle sadece üç düzenleme gerektirir:
- İsteğin nereye gideceğini belirleyen base URL.
- Sağlayıcı başına verilen ve sadece o sağlayıcının sunucularında çalışan API anahtarı.
- Model ID'si, çünkü her sağlayıcı modellerine farklı adlar verir.
Mesajlar, roller, streaming, araçlar ve JSON modu aynı yapıyı korur; bu nedenle geçiş kısadır. Yerleşik bir web arama aracı gibi sağlayıcıya özgü bir özelliğe bağlı olan her şey ayrı yönetim gerektirir.
Üç değeri bir sağlayıcı için tek bir yapılandırma bloğunda veya tek bir ortam dosyasında birlikte tutmak da yardımcı olur. Base URL, anahtar ve model ID yan yana olduğunda, geri geçiş tek satırlık bir değişikliktir ve yeni bir anahtarın eski bir adresle eşleştiği yarı geçiş durumundan kaçınırsınız.
Python: openai paketi
Python'da base URL'ı istemciyi oluştururken ayarlarsınız. Bu örnek, bu sitedeki uç noktaya bağlanır:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Kodunuzu ayarlardan arındırmak isterseniz, bunun yerine ortam değişkenlerini kullanın. SDK, OpenAI() argümansız çağrıldığında OPENAI_BASE_URL ve OPENAI_API_KEY değerlerini okur; bu sayede dağıtım, kod değişikliği olmadan sağlayıcı değiştirebilir. Shell ortamınızda kalan bir değişkenin, dosyada yazdığınız bir değeri geçersiz kılacağını unutmayın.
Node ve curl
Resmi JavaScript paketi aynı seçenek adını kullanır ve camel case olarak yazılır:
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: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
SDK olmadan, base URL basitçe adresin başıdır:
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":"Hello"}]}'
Aynı uç nokta POST /v1/responses'i de kabul eder ve GET /v1/models hizmet verdiği modelleri listeler. Yetkilendirme her durumda Authorization başlığında bir bearer token'dır.
Editörler ve sohbet arayüzleri
GUI araçları base URL'yi farklı etiketler altında gösterir: "API base", "Override OpenAI Base URL", "Custom endpoint" veya "Provider URL". Yapıştırdığınız değer, yukarıdaki koddakiyle aynı dizedir ve /v1 ile biter. Araç tam URL istediğini söylemedikçe tam /chat/completions adresini yapıştırmayın.
Kaydettikten sonra, araç bir liste çekmiyorsa model kimliğini elle ekleyin. Bazı editörler anahtarı sabit bir sağlayıcıyla doğrular ve özel değerleri reddeder; bu durumda önce özel veya OpenAI-uyumlu modu etkinleştiren bir ayar arayın. Cursor'da Kimi tarzı API anahtarı kullanma makalesi, böyle bir aracı detaylı olarak anlatır.
Sağlayıcı değiştirdiğinizde ne değişir
Eşleşen bir format, eşleşen davranış anlamına gelmez. Üretim trafiğini taşımadan önce bu noktaları tek tek kontrol edin:
- Çıktı stili. Farklı bir model farklı şekilde yazar. Gerçek istemlerinizi çalıştırın, basit bir örnek değil.
- Bağlam boyutu. Bu uç nokta, istem ve tamamlama için 100.000 token penceresine sahiptir. Mevcut kurulumunuz daha uzun istemler gönderiyorsa, önce onları kısaltın.
- Limitler. Tam anahtar 8 eşzamanlı istek ve dakikada 300 izin verir. Herhangi bir limite aşmanız durumunda HTTP 429 alırsınız, kod
rate_limitedveyaconcurrencyolur. - Özellikler. SSE üzerinden streaming, tool calling ve JSON modu desteklenir. Görüntü, ses ve video üretimi, embeddings ve fine-tuning desteklenmez; bu metin tabanlı bir API'dir.
- Adlandırma. Hizmet, yasal yetişkin kullanım için içerik reddi olmadan yanıt verecek şekilde seçilmiş tek bir açık ağırlıklı modeli çalıştırır. Moonshot'un resmi API'si değildir ve tedarikçiler arasında bir yönlendirici değildir.
Karşılaştırmayı tarafsız yapmak için aynı on istemi her iki uç noktaya da loglayın ve cevapları yan yana okuyun. Bu dakikalar sürer ve tahmin gerektirmez.
Base URL hataları ve görünümleri
Geçiş sonrası çoğu hata anahtardan değil, adresten kaynaklanır. İşte her hatanın nasıl ortaya çıktığı ve nasıl onarılacağı.
| Hata | Belirti | Çözüm |
|---|---|---|
Sadece ana makine, /v1 yok | Her çağrıda 404 | Sonuna /v1 ekleyin |
| Tam yol yapıştırıldı | Hata mesajında iki katlı yol içeren 404 | Adresi /v1 olarak geri kes |
| Sonda slash ve manuel yol birleştirme | URL'de çift slash | SDK'nın yolu birleştirmesine izin verin |
| Eski anahtar, yeni URL | 401 | Yeni sağlayıcı tarafından verilen anahtarı kullan |
| Eski URL, yeni anahtar | Eski sağlayıcıdan 401 | Eski adresi depo ve kabukta arayın |
http:// yerine https:// | Yönlendirme veya bağlantı hatası | Her yerde https kullan |
Kalanları bulmanın hızlı bir yolu, eski ana makine adını projenizde ve dağıtım ayarlarınızda aramaktır. .env dosyalarında, CI değişkenlerinde, Docker compose dosyalarında ve herhangi bir editör ayarında arayın, çünkü tek bir unutulmuş kopya bile trafiğin bir kısmını eski sağlayıcıya göndermek için yeterlidir.
Geçiş sonrası streaming ve araçlar
stream: true ayarını belirleyin; yanıt, token kullanımı sona erdiğinde bildirilmek üzere server-sent events olarak ulaşır. Fonksiyon çağırma, standart tools ve tool_choice alanlarını kullanır; tool_calls akış halinde gönderilir ve sonuçlar role: "tool" ile mesaj olarak döndürülür. Kodunuz eski sağlayıcı için bunları zaten işliyorsa çalışmaya devam etmelidir; tamamen geçiş yapmadan önce bir akışlı çağrı ve bir fonksiyon çağrısı çalıştırarak doğrulayın. Akışlı bir istek, akış sona erene kadar concurrency slotunu tutar.
Geçiş öncesi maliyet kontrolü
Faturalandırma token başına: ön ödemeli krediden 1M input token başına $0,15 ve 1M output token başına $0,50, abonelik yok. Başarısız veya reddedilen istekler ücretlendirilmez ve kredi süresi dolmaz. Başka bir sağlayıcının ücretleri için, bunlar değiştiğinden mevcut fiyatlandırma sayfalarına bakın.
Bir örnek. Bir istek 2.000 input token ve 500 output token içeriyorsa:
- Girdi: 2.000 / 1.000.000 x $0,15 = $0,0003
- Çıktı: 500 / 1.000.000 x $0,50 = $0,00025
- Toplam: istek başına $0,00055, yani 1.000 istek $0,55 tutarında
En küçük bakiye yükleme $20'dir ve daha büyükler bonus ekler: $50'den +5%, $100'den +10% ve $200'den +15%. Sadece kripto (TRC20 üzerinde USDT, Base üzerinde USDC) kabul edilir. Tam detaylar fiyatlandırma sayfasında ve Kimi odaklı açıklama Kimi API anahtarı fiyatlandırması'dadır.
Bir anahtar alın ve ilk isteği gönderin
Google veya e-posta ile şifre kullanarak kaydolun, ardından API anahtarı sayfasını açın. Yeni kullanıcılar tek tıklamayla kişi başı $0,50 değerinde ücretsiz deneme kredisi talep edebilir; bu kredi 7 gün boyunca geçerlidir ve kart bilgisi gerektirmez. Deneme anahtarları 2 eşzamanlı istek ve dakika başına 60 istek ile sınırlıdır; bu da bir test çalışması için yeterlidir.
Anahtarı yukarıdaki Python kod parçasına yapıştırın ve çalıştırın, metin döndüğünü doğrulayın. belgeler her parametreyi listeler ve yanıt başlıkları X-Request-Id ile X-Balance-USD hata ayıklama ve bakiye takibi için yardımcı olur. Servise gönderilen istemler eğitim için kullanılmaz.
Daha fazla kılavuz
- Kimi API Anahtarı Çalışmıyor: Nedenler, Çözümler, Yedek Plan
- Cursor'da Kimi Tarzı API Anahtarı Kullanma: Kurulum Kılavuzu
Sıkça Sorulan Sorular
Model, Moonshot'un resmi Kimi'si ile aynı mı?
Hayır, sansürsüz olması için ayarlanmış açık ağırlıklı bir model barındırıyoruz. Bu bir GPT, Claude, Gemini, Grok, DeepSeek veya başka bir tedarikçinin modeli değildir. Kendi sunucularımızda çalışan ayrı bir modeldir.
Verilerimle eğitim yapıyor musunuz?
Hayır. İstemleriniz ve tamamlamalarınız eğitim için kullanılmaz. Gizliliğe ve şeffaflığa değer veriyoruz, bu nedenle verileriniz size ait kalır.
Hız limitleri nelerdir?
Her anahtar başına dakikada 300 istekle sınırlısınız. Maksimum istek gövdesi boyutu 8 MB'tır. Bu limitler, tüm kullanıcılar için kararlı performansın sağlanması için tasarlanmıştır.
İçerik politikası nedir?
Model, yetişkinlere yönelik, tartışmalı ve yaratıcı konular konusunda sansürsüzdür. Ancak, reşit olmayanlarla ilgili cinsel içerikler engellenir. Bu, abonelik seviyenizden bağımsız olarak her zaman geçerli olan katı bir sınırlamadır.
Sorular ve cevaplar
Base URL'yi değiştirdiğimde kodumu değiştirmem mi gerekir?
Genellikle yalnızca üç değer bulunur: temel URL, API anahtarı ve model kimliği. Mesaj formatı, akış ve fonksiyon çağırma, yeni sağlayıcı bunları desteklediği sürece aynı kalır.
Base URL /v1 ile bitmeli mi?
Bu uç nokta için evet: https://api.kimiapikey.com/v1. SDK /chat/completions son ekini kendisi ekler, bu nedenle onu dahil etmeyin.
Bu resmi Moonshot API'si mi?
Hayır. Bu, OpenAI ile uyumlu bir API arkasında bağımsız olarak barındırılan açık ağırlıklı bir modeldir. Moonshot'un servisi değildir ve tedarikçiler arasında bir yönlendirici değildir.
Model ID'sini nereden bulabilirim?
Anahtarınızla GET /v1/models çağrısı yapın. Bu uç noktada model ID'si uncensored'dır.
Anahtarınız tek bir formun uzağında
Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulum bu kadar basit.