TR ▾
API anahtarını al

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

Değişen API base URL'ını gösteren, bir anahtar panosundaki iki soket arasında hareket ettirilen bir kablo
API sunucusuna parlayan bir kablo ile bağlantılı izometrik bir kod editörü illüstrasyonu

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:

  1. İsteğin nereye gideceğini belirleyen base URL.
  2. Sağlayıcı başına verilen ve sadece o sağlayıcının sunucularında çalışan API anahtarı.
  3. 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_limited veya concurrency olur.
  • Ö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ğı.

HataBelirtiÇözüm
Sadece ana makine, /v1 yokHer çağrıda 404Sonuna /v1 ekleyin
Tam yol yapıştırıldıHata mesajında iki katlı yol içeren 404Adresi /v1 olarak geri kes
Sonda slash ve manuel yol birleştirmeURL'de çift slashSDK'nın yolu birleştirmesine izin verin
Eski anahtar, yeni URL401Yeni sağlayıcı tarafından verilen anahtarı kullan
Eski URL, yeni anahtarEski sağlayıcıdan 401Eski 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.

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.

API anahtarı alDokümantasyonu oku