TR ▾
API anahtarı al

İ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.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Base URLhttps://api.kimiapi.top/v1
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Model kimliğiuncensored
Bağlam penceresi100.000 token (girdi + çıktı)
JSON moduresponse_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
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Fonksiyon çağırmaevet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak
Hız limitianahtar başına dakikada 300 istek
Eşzamanlılıkanahtar başına aynı anda 8 istek
İstek boyutuen 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
Fiyat1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00
YüklemeUSDT (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
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

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.