Szybki start API Mukenetsu AI

Konfiguracja i Base URL

Mukenetsu AI jest zaprojektowany jako REST API kompatybilne z OpenAI. Dzięki temu możesz używać istniejących klientów i SDK OpenAI po wprowadzeniu niewielkich zmian. Do komunikacji z API użyj następującego adresu bazowego.

https://api.mukenetsuapi.com/v1

W przeciwieństwie do innych usług LLM, nie musisz wybierać skomplikowanych endpointów ani konfigurować dodatkowych opcji. Udostępniamy tylko endpoint uzupełniania czatu i endpoint listy modeli. Ta prosta struktura przyspiesza rozwój.

Klucz API można natychmiast uzyskać podczas rejestracji na stronie Get API key za pomocą adresu e-mail i hasła. Nie jest wymagana żadna akcja w panelu. Dane promptów nie są wykorzystywane do trenowania modelu.

Autoryzacja i klucz API

Dostęp do API wymaga autoryzacji nagłówkiem Authorization: Bearer <API_KEY>. Użyj klucza wygenerowanego przy tworzeniu konta. Każdemu kontu przypisany jest jeden klucz API, który możesz wygenerować ponownie w dowolnym momencie. Po regeneracji poprzedni klucz traci ważność.

W przypadku błędu uwierzytelniania zwracane są zwykle odpowiedzi 401 (Unauthorized) lub 402 (Payment Required). Kod 401 oznacza, że klucz jest nieprawidłowy lub unieważniony, a kod 402 oznacza, że saldo kredytu jest niewystarczające. Kredyt jest przedpłacony i można go doładować od kwoty $10 za pomocą kryptowalut (USDT, USDC).

Endpoint uzupełniania czatu

Głównym endpointem do generowania tekstu jest POST /v1/chat/completions. Wyślij żądanie, aby wygenerować tekst z uwzględnieniem historii rozmowy i promptu systemowego. Użyj ID modelu uncensored. Jest to nasz własny model o otwartych wagach, inny niż GPT czy modele innych dostawców.

Poniższy przykład pokazuje, jak wygenerować tekst za pomocą curl. Wymagane parametry to ID modelu, wiadomości oraz opcjonalnie włączenie strumieniowania.

コピー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."}]
  }'

Ten endpoint nie obsługuje embeddingów, generowania obrazów ani konwersji mowy. Specjalizuje się wyłącznie w uzupełnianiu i generowaniu tekstu.

Strumieniowanie (SSE)

Jeśli chcesz otrzymywać wygenerowany tekst w czasie rzeczywistym, użyj trybu strumieniowania. Dodaj "stream": true do żądania, a serwer będzie zwracać dane w formacie SSE. Dzięki temu użytkownik może wyświetlać fragmenty tekstu przed zakończeniem generowania.

Jeśli używasz SDK OpenAI w Pythonie lub biblioteki klienta Node.js, strumieniowanie zostanie automatycznie włączone po ustawieniu opcji stream=True. Obsługa zdarzeń będzie otrzymywać cząstki tokenów.

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

Strumieniowanie to ważna funkcja poprawiająca UX w przypadku długich odpowiedzi lub aplikacji interaktywnych. Pamiętaj jednak, że przy utracie połączenia podczas strumieniowania przestajesz odbierać zdarzenia.

Narzędzia / wywoływanie funkcji

API Mukenetsu AI obsługuje wywoływanie funkcji (narzędzi), co ułatwia integrację z zewnętrznymi API i bazami danych. Dodaj pole tools i parametr tool_choice do ciała żądania, aby wymusić wykonanie konkretnej funkcji przez model.

Model sam decyduje, czy wywołać funkcję, czy zwrócić zwykły tekst. Po zakończeniu wywołania możesz dodać wynik funkcji do messages i przekazać go modelowi, aby uzyskać bardziej szczegółową odpowiedź.

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

Funkcja ta jest szczególnie przydatna w aplikacjach typu agent lub przy automatyzacji złożonych zadań. Dzięki kompatybilności z formatem OpenAI możesz wykorzystać istniejącą logikę wywoływania funkcji.

Limit zapytań i ograniczenia

Istnieją następujące ograniczenia: maks. 300 zapytań na minutę i maksymalny rozmiar ciała żądania 8 MB. Przekroczenie powoduje błąd 429 (Too Many Requests). Okno kontekstu wynosi 100 000 tokenów (suma promptu i tekstu wygenerowanego). Dłuższe rozmowy lub dokumenty należy odpowiednio podzielić.

Podczas odbierania odpowiedzi strumieniowej postępuj zgodnie z tym przepływem zdarzeń.

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

Treści erotyczne z udziałem nieletnich są ściśle ograniczone ze względu na przepisy prawne. Pozostałe treści dla dorosłych, fikcja, badania bezpieczeństwa i tematy kontrowersyjne są generowane bez cenzury.