TR ▾
API anahtarı al

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 isteklerde Authorization 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ğinize stream=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çin tools 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.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Base URLhttps://api.kimiapi.cc/v1
Model kimliğiuncensored
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Uç noktalarPOST /v1/chat/completions · GET /v1/models
JSON moduresponse_format: {"type": "json_object"}
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Bağlam penceresi100.000 token (girdi + çıktı)
Fonksiyon çağırmaevet — 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 boyutuen fazla 8 MB
Hız limitianahtar 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ıkanahtar 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üklemeUSDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar
Bonus$50'dan itibaren +%5, $100'dan itibaren +%10
Fiyat1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00
GirişGoogle veya e-posta ve şifre
Anahtarlarhesap başına bir aktif anahtar; yenisi eskisinin yerini alır
İçerikyetiş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.

KodTürAnlamı
400bad_requestgeçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun
401missing_key · invalid_key · key_revokedanahtar yok, yanlış veya değiştirilmiş
402no_creditkredi bitti — yükleyin, hemen devam eder
403content_blockedreşit olmayanları içeren cinsel içerik — reddedildi, ücret yok
404not_foundbilinmeyen uç nokta
413request_too_largegövde 8 MB'tan büyük
429rate_limited · concurrencydakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin
503upstream_busymodel 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.

API anahtarı al