Mukenetsu AI API Hızlı Başlangıç

Temel ayarlar ve Base URL

Mukenetsu AI, OpenAI uyumlu bir REST API olarak tasarlanmıştır. Bu sayede mevcut OpenAI istemci ve SDK'larını küçük değişikliklerle kullanabilirsiniz. API iletişimi için aşağıdaki base URL'yi kullanın.

https://api.mukenetsuapi.com/v1

Diğer LLM hizmetlerinin aksine karmaşık uç nokta seçimi veya ek ayar gerekmez. Yalnızca tek bir chat completion uç noktası ve model listesi uç noktası sağlanır. Bu basit yapı geliştirme sürecini hızlandırır.

API anahtarı, API anahtarını al sayfasında e-posta adresiniz ve şifrenizle kayıt olurken, kayıt sırasında anında almanız mümkündür. Dashboard işlemlerine gerek yoktur. Ayrıca gizliliğe önem veririz; istem verileri model eğitimi için kullanılmaz.

Kimlik doğrulama ve API anahtarı

API erişimi için Authorization: Bearer <API_KEY> başlığıyla kimlik doğrulaması gerekir. Mukenetsu AI API anahtarı, hesap oluşturulduğunda üretilen anahtardır. Bir hesap için bir anahtar atanır; gerekirse istediğiniz zaman yeniden oluşturabilirsiniz. Anahtar yenilendiğinde önceki anahtar geçersiz olur.

Kimlik doğrulama hatası oluştuğunda genellikle 401 (Yetkisiz) veya 402 (Ödeme Gerekli) yanıtı döndürülür. 401, anahtarın yanlış veya geçersiz olduğunu; 402 ise hesap bakiyenizin yetersiz olduğunu gösterir. Bakiye ön ödemelidir ve kripto para birimleriyle (USDT, USDC) 10 $'dan yükleyebilirsiniz.

Chat completion uç noktası

Metin üretiminin temel uç noktası POST /v1/chat/completions'dir. Bu uç noktaya istek göndererek konuşma geçmişi veya sistem istemi dahil metin üretebilirsiniz. Model ID olarak uncensored belirtin. Bu, OpenAI GPT veya diğer sağlayıcıların modellerinden farklı, bağımsız bir açık ağırlıklı modeldir.

Aşağıdaki örnek, curl kullanarak temel metin üretiminin nasıl yapılacağını gösterir. Gerekli parametreler model ID, mesajlar ve isteğe bağlı olarak akış etkinleştirme seçeneğidir.

コピーcurl https://api.mukenetsuapi.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."}]
  }'

Bu uç noktada embedding, görüntü üretimi veya ses dönüştürme gibi işlevler sağlanmaz. Saf metin tamamlama ve üretimi üzerine özelleşmiştir.

Akış (SSE)

Oluşturulan metni gerçek zamanlı almak için akış modunu kullanın. İsteğe "stream": true eklerseniz sunucu verileri SSE formatında sırayla döndürür. Bu sayede kullanıcı, üretim tamamlanmadan metnin bir kısmını görüntüleyebilir.

Python OpenAI SDK veya Node.js istemci kütüphanesi kullanıyorsanız, stream=True seçeneğini belirtmeniz yeterlidir; akış işlemi otomatik olarak gerçekleştirilir. Olay işleyicisi token başına parçalar alır.

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.mukenetsuapi.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)

Akış, uzun yanıtlar veya etkileşimli uygulamalarda kullanıcı deneyimini artırmak için önemlidir. Ancak akış sırasında bağlantı kesilirse sonraki olaylar alınamaz.

Araçlar/fonksiyon çağırma

Mukenetsu AI API fonksiyon çağırma (tool) desteği sunar. Bu sayede harici API veya veritabanları ile entegrasyon kolaylaşır. İstek gövdesine tools alanını ve tool_choice parametresini ekleyerek modele belirli bir fonksiyon yürüttebilirsiniz.

Model, gerektiğinde fonksiyon çağırır veya normal metin döndürür. Çağrı tamamlandığında fonksiyon sonucunu messages içine ekleyerek modele gönderirseniz daha detaylı yanıt alabilirsiniz.

コピーimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mukenetsuapi.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);

Bu özellik ajan tabanlı uygulamalar ve karmaşık görev otomasyonu için özellikle faydalıdır. OpenAI uyumlu formatta olduğu için mevcut araç çağırma mantığını doğrudan kullanabilirsiniz.

Hız limiti ve kısıtlamalar

API kullanımında aşağıdaki sınırlamalar vardır: Dakikada en fazla 300 istek, istek gövdesi maksimum 8 MB. Bunları aşarsanız 429 (Too Many Requests) hatası alırsınız. Bağlam penceresi 100,000 token (istem + üretilen metin toplamı) kadardır. Bu sınırı aşan uzun konuşmalar veya belgeler uygun şekilde bölünerek gönderilmelidir.

Akış yanıtı alırken aşağıdaki olay akışını izleyin.

コピー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)

Ayrıca, reşit olmayanlarla ilgili cinsel içerik katı şekilde kısıtlanmıştır; bu yasal uyumluluk içindir. Diğer yasal yetişkin içerikleri, kurgu, güvenlik araştırmaları ve tartışmalı konular sansürsüz üretilir.