TR ▾
API anahtarı al

kimiapikey.comDokümantasyon

Kimi API: İlk istek beş dakikada

Standart OpenAI uyumlu arayüz kullanarak beş dakikadan kısa sürede ilk yanıtınızı alın. Bu kılavuz, sansürsüz model için kurulumu, kimlik doğrulamayı ve temel kullanımı kapsar.

API anahtarı al

Önkoşullar

Başlamak için kimiapikey.com'den bir API anahtarına ihtiyacınız var. Deneme için yalnızca e-posta ve şifre ile kaydolun; kredi kartı gerekmez. Resmi veya uyumlu bir SDK yüklü olan desteklenen bir dil ortamına da ihtiyacınız vardır. API'miz OpenAI chat-completions formatını takip ettiği için GPT-3.5/4 için mevcut kodlar genellikle minimum değişikliklerle çalışır. SDK sürümünüzün base_url parametresini destekleyecek kadar güncel olduğundan emin olun.

Temel URL ve Kimlik Doğrulama

API'miz https://api.kimiapikey.com/v1 adresinde çalışır. Kimlik doğrulama standart Authorization başlığı aracılığıyla yapılır. Anahtarınızı Bearer token olarak iletin. Bu, OpenAI uyumlu uç nokta kabul eden herhangi bir istemciyle çalışır. Bir proxy veya özel istemci kullanıyorsanız, Authorization başlığının doğru şekilde iletildiğinden emin olun. İsteyeceğiniz model kimliği uncensored olacaktır.

İlk İstek

Kurulumunuzu doğrulamak için basit bir sohbet tamamlama isteği gönderin. Aşağıdaki curl komutunu kullanın ve YOUR_API_KEY yerine gerçek anahtarınızı yazın. Bu istek, uncensored modeline kısa bir istem gönderir. Başarılı olursa, modelin yanıtını içeren bir JSON yanlı alırsınız. Oluşturulan metni choices dizisinde kontrol edin. 401 hatası alırsanız anahtarınız geçersiz veya süresi dolmuş demektir.

Python SDK

En kolay entegrasyon için resmi OpenAI Python kütüphanesini kullanın. base_url değerini uç noktamıza ayarlayın ve anahtarınızı sağlayın. Bu örnek temel bir metin oluşturma çağrısını gösterir. Gerekirse model parametresini ayarlayabilirsiniz, ancak varsayılan değer uncensored'dir. Bu yaklaşım, kodunuzu farklı OpenAI uyumlu hizmetler arasında taşınabilir kılar.

Node SDK

JavaScript/TypeScript projeleri için openai npm paketini kullanın. İstemciyi temel URL'miz ve API anahtarınızla yapılandırın. Bu, Node ortamınızdan doğrudan istek yapmanızı sağlar. Sözdizimi Python SDK'yı yansıtır, böylece dil değiştirirseniz tutarlılık sağlanır. await kullanarak asenkron yanıtları doğru şekilde işlemeyi unutmayın.

Akış Yanıtları

Gerçek zamanlı çıktı için SDK'nızda akışı etkinleştirin. Bu, metin parçaları oluşturuldukça gönderilerek algılanan gecikmeyi azaltır. İsteğinizde stream bayrağını kullanın. SDK kısmi yanıtlar sağlayarak UI'nın kademeli olarak güncellenmesine olanak tanır. Bu, anında geri bildirim değerli olan sohbet arayüzleri veya uzun formatlı içerik oluşturma için idealdir.

Limitler ve Hatalar

Her anahtar dakika başına 300 istekle sınırlıdır. Bu sınırı aşarsanız 429 hatası alırsınız. İstek gövmeniz 8 MB'ı geçmemelidir. 100.000 token'lık bağlam penceresi, istem ve tamamlama toplamına uygulanır. Yaygın hatalar arasında 401 (geçersiz anahtar) ve 402 (yetersiz kredi) yer alır. API'yi kullanmaya devam etmek için panelden bakiye yükleyin. Krediler asla sona ermez ve aylık ücret yoktur.

cURL

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": "Write a blunt product review of a cheap VPN."}]
  }'

Python

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": "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.kimiapikey.com/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)

Sorular ve cevaplar

API fonksiyon çağırma'yı destekliyor mu?

Evet, uç nokta standart OpenAI formatında tool/fonksiyon çağırma'yı destekler. İsteğinizde araçları tanımlayabilir ve model yapılandırılmış argümanlar döndürür.

Hız limitini aşarsam ne olur?

429 Too Many Requests hatı alırsınız. Kısa bir süre bekleyip yeniden deneyin veya daha yüksek aktarım hızını sürdürmek için ön ödemeli kredi seviyenizi yükseltin.

Model, verilerim üzerinde eğitilmiş mi?

Hayır. API'ye gönderilen istemler eğitim için kullanılmaz. Verileriniz gizli kalır ve temel modelin iyileştirilmesinde kullanılmaz.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulum bu kadar basit.

API anahtarı alDokümantasyonu oku

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
Model kimliğiuncensored
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Maksimum çıktı100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok)
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
Akışevet — server-sent events; son parça token kullanımını içerir
Bağlam penceresi100.000 token (girdi + çıktı)
JSON moduresponse_format: {"type": "json_object"}
Eşzamanlılıkanahtar başına aynı anda 8 istek
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
İstek boyutuen fazla 8 MB
Fiyat1M girdi token'ı $0,15 · 1M çıktı token'ı $0,50
Faturalamaön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz
Bonus$50'dan itibaren +%5, $100'dan itibaren +%10, $200'dan itibaren +%15
Geçerliliködenen kredinin süresi dolmaz, abonelik yok
YüklemeUSDT (TRC20) veya USDC (Base), $20–$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)
Anahtarlarhesap başına bir aktif anahtar; yenisi eskisinin yerini alır
GirişGoogle veya e-posta ve şifre
İç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