PL ▾
Pobierz klucz API

Pierwsze wywołanie bezcenzuralnego AI API i połączenie z OpenAI SDK

Jeśli zaczynasz pracę z bezcenzuralnym API AI, potrzebujesz tylko klucza API i zmiany base URL. Jeśli masz już kod napisany w OpenAI SDK, wystarczy zmienić adres i nazwę modelu, aby otrzymać pierwszą odpowiedź.

Data aktualizacji

Izometryczna ilustracja pokazująca przepływ danych przez bramę API podłączoną do kompatybilnego konektora OpenAI

Kluczowe wnioski

  • Podstawowy adres URL to https://api.mugeomyeolapi.com/v1, a identyfikator modelu to uncensored.
  • Obsługujemy endpointy chat/completions, responses i models oraz strumieniowanie, wywoływanie funkcji i tryb JSON.
  • Błędy 429 dzielą się na rate_limited i concurrency; sposób postępowania zależy od przyczyny.
  • Tylko tekst, żadna treść seksualna z udziałem nieletnich nie jest dozwolona w żadnym przypadku.

Przygotuj się przed rozpoczęciem

Potrzebujesz trzech rzeczy: klucza, base URL i ID modelu. Resztę obsługuje Twój zwykły klient kompatybilny z OpenAI.

  1. Zarejestruj się. Możesz się zarejestrować za pomocą konta Google lub e-maila i hasła.
  2. Wygeneruj klucz na stronie wydawania klucza API. Nowi użytkownicy mogą otrzymać $0,50 kredytu próbnego jednym kliknięciem. Limit: 1 raz na osobę, ważność 7 dni, bez podawania danych karty.
  3. W base URL podaj https://api.mugeomyeolapi.com/v1, a w modelu uncensored.

Uwierzytelnianie odbywa się za pomocą standardowego nagłówka Authorization: Bearer <klucz>. Nie wpisuj klucza bezpośrednio do kodu, przechowuj go w zmiennej środowiskowej. Poniższe przykłady odczytują zmienną MUGEOMYEOL_API_KEY.

Pierwsze wywołanie w Pythonie

Zainstaluj pakiet openai (wersja v1 lub nowsza) i podczas tworzenia klienta zmień tylko base_url.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mugeomyeolapi.com/v1",
    api_key=os.environ["MUGEOMYEOL_API_KEY"],
)

res = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "당신은 간결하게 답하는 한국어 어시스턴트입니다."},
        {"role": "user", "content": "HTTP 429 오류가 무엇인지 두 문장으로 설명해 줘."},
    ],
    temperature=0.7,
)
print(res.choices[0].message.content)
print(res.usage)

W odpowiedzi usage znajdują się liczby tokenów wejściowych i wyjściowych. Koszt jest obliczany na ich podstawie. Pozostały saldo widoczne jest bezpośrednio w nagłówku odpowiedzi X-Balance-USD. W Python SDK dostęp do nagłówków uzyskasz przez with_raw_response.

import os
from openai import OpenAI
client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])
raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "안녕"}],
)
print("잔액(USD):", raw.headers.get("X-Balance-USD"))
completion = raw.parse()
print(completion.choices[0].message.content)

Przykłady w curl i Node.js

Jeśli chcesz tylko sprawdzić działanie bez użycia SDK, curl jest najszybszą opcją. Jest przydatny do weryfikacji poprawności działania klucza.

curl https://api.mugeomyeolapi.com/v1/chat/completions \
  -H "Authorization: Bearer $MUGEOMYEOL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "한 줄로 자기소개해 줘."}]
  }'

Struktura w Node.js jest taka sama.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mugeomyeolapi.com/v1",
  apiKey: process.env.MUGEOMYEOL_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "짧은 시를 한 편 써 줘." }],
  stream: true,
  stream_options: { include_usage: true },
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Strumieniowanie włącza się jednym parametrem stream: true i jest przesyłane przez SSE. Zużycie zasobów możesz sprawdzić na końcu strumienia. Listę dostępnych modeli uzyskasz przez GET /v1/models. Usługa obsługuje tylko jeden model uncensored, więc lista jest krótka.

Często używane parametry

Większość parametrów używanych w OpenAI Chat Completions działa bez zmian. Oto zestawienie najczęściej używanych:

ParametrZastosowanie
temperature, top_pRegulacja losowości odpowiedzi. Łatwiej przewidzieć wynik, jeśli dostosujesz tylko jeden z tych parametrów, zamiast zmieniać oba jednocześnie.
stop, seedOkreślanie ciągu końcowego, próba zapewnienia reprodukowalności
kary za obecność/częstotliwośćTłumienie powtórzeń
max_tokensOpcjonalne. Jeśli pominiemy, można wykorzystać całą pozostałą część okna kontekstu.
tools, tool_choiceWywoływanie funkcji. Wyniki są zwracane jako komunikat role: "tool".
response_formatWłącz tryb JSON za pomocą {"type":"json_object"}.

Okno kontekstu wynosi 100 000 tokenów (łącznie z promptem i outputem). Przy długich dokumentach upewnij się, że input nie zajmuje większości tej limity. W trybie JSON warto dodać do promptu instrukcję, by model odpowiadał w formacie JSON — zwiększa to stabilność.

import os, json
from openai import OpenAI

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"])

res = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "도시 3곳의 이름과 인구 규모 느낌을 JSON 객체로 줘. 키는 cities 하나."}],
)
data = json.loads(res.choices[0].message.content)
print(data)

Istnieją również inne endpointy niż POST /v1/chat/completions, np. POST /v1/responses. Jeśli tworzysz nowy kod i używasz formatu Responses, możesz go wywołać pod tym samym base URL. Szczegóły pól znajdziesz w dokumentacji API.

Kody błędów i obsługa ponownych prób

Pierwszym błędem, na który natkniesz się, jest HTTP 429. W tym serwisie ma on dwa znaczenia.

  • rate_limited: Przekroczono limit zapytań na minutę. Dla oficjalnego klucza wynosi on 300 zapytań na minutę, a dla klucza testowego — 60.
  • concurrency: Zbyt wiele zapytań jest obecnie przetwarzanych równolegle. Dla klucza produkcyjnego limit wynosi 8, a dla klucza próbny — 2.

Serwer zwraca 429 również przy chwilowym przeciążeniu; wtedy nagłówek Retry-After: 5 podaje czas oczekiwania. Wyślij zapytanie ponownie po 5 sekundach. Pamiętaj, że żądanie strumieniowe zajmuje jedno miejsce w limicie concurrency do momentu zakończenia strumienia. Jeśli otworzysz strumień, ale go nie zamkniesz, szybko wyczerpiesz limit concurrency.

import os, time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mugeomyeolapi.com/v1", api_key=os.environ["MUGEOMYEOL_API_KEY"], max_retries=0)

def ask(prompt, tries=5):
    for i in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (i + 1))  # 5초, 10초, 15초 ... 점점 늘려 기다림
    raise RuntimeError("재시도 한도를 넘었습니다")

print(ask("테스트 메시지"))

Jeśli problemem jest concurrency, lepiej ograniczyć liczbę wywołań za pomocą semafora po stronie klienta niż polegać na ponownych próbach. Aktualny limit Twojego klucza możesz sprawdzić w nagłówkach odpowiedzi: X-RateLimit-Limit-Requests oraz X-RateLimit-Limit-Concurrency. Maksymalny rozmiar treści żądania to 8 MB. Za zapytania nieudane lub odrzucone nie naliczamy opłat. Przy zgłaszaniu problemu podaj nagłówek X-Request-Id — ułatwi to zespołowi wsparcia technicznego zidentyfikowanie przyczyny.

Zasady użytkowania i znane limity

Serwis jest API uruchamianym przez niezależnego operatora, opartym na jednym modelu o otwartych wagach, dostrojonym do udzielania odpowiedzi bez odrzucania treści dla dorosłych użytkowników. Nie jest to oficjalne API żadnej z firm (Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google, Anthropic itp.) ani router rozdzielający zapytania między modele różnych dostawców. Znajomość tej różnicy jest kluczowa przy wyborze API bez cenzury, aby nie mylić dokumentacji z rzeczywistym zachowaniem serwisu.

  • Treści erotyczne z udziałem nieletnich są niedozwolone w każdym przypadku. Ten limit nie ulega zmianie.
  • Obsługiwany jest wyłącznie tekst. Nie oferujemy generowania obrazów, głosu ani wideo, a także embeddingów i fine-tuningu.
  • Wpisane prompty nie są używane do trenowania modelu. Więcej informacji znajdziesz w polityce prywatności.

Brak odrzuceń w odpowiedziach nie oznacza braku odpowiedzialności. Twórca serwisu musi przestrzegać regulaminu i obowiązujących przepisów prawa.

Koszty i doładowanie

Cena wynosi $0,15 za 1 mln tokenów inputu oraz $0,50 za 1 mln tokenów outputu; kwoty są pobierane z przedpłaconego kredytu. Nie ma subskrypcji, a kredyt nie wygasa. Przykładowo: jedno zapytanie z 2000 tokenami inputu i 500 tokenami outputu kosztuje łącznie $0,00055 ($0,0003 za input i $0,00025 za output). Wysyłając 1000 takich zapytań, zapłacisz łącznie $0,55.

Z kredytu próbnego $0,50 możesz wypróbować około 900 żądań w tej skali. Doładowania są możliwe w kwotach całkowitych od $20 do $500, z bonusem 5% przy $50+, 10% przy $100+ i 15% przy $200+. Metody płatności: USDT (TRC20) i USDC (Base). Szczegółowa tabela cen znajduje się na stronie z opłatami.

Więcej poradników

Najczęściej zadawane pytania

Jak bardzo muszę zmodyfikować kod z OpenAI SDK?

Wystarczy zmienić trzy rzeczy: base URL, klucz API oraz nazwę modelu. ID modelu to uncensored, a base URL to https://api.mugeomyeolapi.com/v1.

Jak uzyskać kredyt testowy?

Po rejestracji otrzymasz $0,50 po jednym kliknięciu przycisku na stronie klucza API. Limit to 1 raz na użytkownika, ważność 7 dni, bez konieczności podawania danych płatniczych.

Co zrobić, gdy pojawi się błąd 429?

Najpierw sprawdź, czy kod błędu to rate_limited, czy concurrency. Pierwszy oznacza przekroczenie limitu zapytań na minutę, drugi — limitu zapytań równoległych. Jeśli nagłówek Retry-After jest obecny, odczekaj podany czas i wyślij zapytanie ponownie.

Czy mogę generować obrazy?

Nie. To API obsługuje wyłącznie tekst; nie obsługujemy generowania obrazów, głosu, wideo ani embeddingów.

Czy mogę przesłać długi dokument naraz?

Możesz użyć do 100 000 tokenów (łącznie z promptem i outputem). Maksymalny rozmiar treści żądania to 8 MB.

Klucz API tylko po rejestracji

Utwórz konto, skopiuj klucz, zmień base URL. To wszystko, co musisz skonfigurować.

Pobierz klucz API
Pobierz klucz API