Sansürsüz AI API ile ilk istek ve OpenAI SDK bağlantısı
Sansürsüz AI API'yi ilk kez kullanıyorsanız tek ihtiyacınız olan API anahtarı ve base URL değişikliğidir. Zaten OpenAI SDK ile yazılmış kodunuz varsa, adresi ve model adını değiştirmeniz yeterli olacaktır.
Güncelleme tarihi:

Özet
- Base URL https://api.mugeomyeolapi.com/v1, model ID'si uncensored'dır.
- chat/completions, responses, models uç noktaları ile akış, fonksiyon çağırma ve JSON modu desteklenir.
- 429 hataları rate_limited ve concurrency olarak ikiye ayrılır ve nedenlerine göre farklı yaklaşımlar gerektirir.
- Yalnızca metin desteklenir; reşit olmayanların yer aldığı cinsel içerik hiçbir durumda kabul edilmez.
Başlamadan önce hazırlıklar
Üç şeye ihtiyacınız var: anahtar, base URL ve model ID. Gerisi, kullandığınız OpenAI uyumlu istemci tarafından halledilir.
- Kaydolun. Google hesabınızla veya e-posta ve şifre ile kayıt olabilirsiniz.
- API anahtarı oluşturma sayfası üzerinden anahtarınızı oluşturun. Yeni kullanıcılar bu sayfadan tek tıkla $0,50 ücretsiz deneme kredisi alabilir. Kişi başı 1 kez, geçerlilik süresi 7 gündür; ödeme bilgisi gerekmez.
- Base URL olarak
https://api.mugeomyeolapi.com/v1, model olarak iseuncensoreddeğerini belirtin.
Kimlik doğrulama standart Authorization: Bearer <anahtar> başlığını kullanır. Anahtarı kodun içine gömmeyin, ortam değişkenine atayın. Aşağıdaki örnekler MUGEOMYEOL_API_KEY değişkenini okur.
Python ile ilk istek
openai paketini (v1 ve üzeri) kurduktan sonra istemci oluştururken yalnızca base_url değerini değiştirmeniz yeterlidir.
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)
usage alanı girdi ve çıktı token sayılarını içerir. Ücretlendirme bu sayılara göre yapılır. Kalan bakiyeyi yanıt başlıklarında X-Balance-USD üzerinden doğrudan görebilirsiniz. Python SDK'de başlıklara erişmek için with_raw_response kullanın.
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)curl ve Node.js örnekleri
SDK kullanmadan yalnızca kontrol etmek isterseniz curl en hızlı seçenektir. Anahtarınızın doğru çalışıp çalışmadığını kontrol etmek için idealdir.
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": "한 줄로 자기소개해 줘."}]
}'
Node.js'de de yapı aynıdır.
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 ?? "");
}
Akış, stream: true ile tek bir parametreyle açılır ve SSE ile iletilir. Kullanım bilgisi akış sonunda görünür. Mevcut modelleri GET /v1/models ile listeleyebilirsiniz. Bu hizmette yalnızca uncensored modeli olduğu için liste kısadır.
Sık kullanılan parametreler
OpenAI Chat Completions'ta kullandığınız parametrelerin çoğu doğrudan geçerlidir. Yaygın kullanılanlar şunlardır:
| Parametre | Amaç |
|---|---|
temperature, top_p | Yanıtın rastgeleliğini ayarlar. İkisini birden yüksek değerlere çekmek yerine yalnızca birini ayarlamak sonuçları öngörülebilir kılar. |
stop, seed | Durdurma dizgesi belirleme, tekrarlanabilirlik sağlama |
| varlık/sıklık cezası | Tekrar baskılama |
max_tokens | İsteğe bağlı. Belirtilmezse bağlam penceresinin kalan kısmı kullanılabilir. |
tools, tool_choice | Araç çağırma. Sonuçlar role: "tool" mesajı olarak döndürülür. |
response_format | JSON modunu {"type":"json_object"} ile açın. |
Bağlam penceresi, istem ve çıktıyı birlikte 100.000 token'dır. Uzun belgeler eklerken, girişin bu sınırın büyük kısmını oluşturmadığından emin olun. JSON modu kullanırken, istemin de JSON olarak yanıt vermesini belirtirseniz daha istikrarlı olur.
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)
Uç nokta, POST /v1/chat/completions dışında POST /v1/responses'dir. Yeni oluşturulan kodda Responses biçimini kullanıyorsanız, aynı base URL'den çağrı yapmanız yeterlidir. Ayrıntılı alanlar API belgeleri'nde doğrulanabilir.
Hata kodları ve yeniden deneme işleme
Karşılamanız muhtemel ilk hata HTTP 429'dir. Bu hizmette iki farklı anlamı vardır.
- rate_limited: Dakikadaki istek sayısını aştınız. Normal anahtar dakikada 300 istek, deneme anahtarı dakikada 60 istek yapabilir.
- concurrency: Aynı anda işlenen istek sayısı çok fazla. Normal anahtar 8, deneme anahtarı 2 eşzamanlı istek yapabilir.
Sunucu geçici olarak meşgul olduğunda da 429 hatası alınır; bu durumda Retry-After: 5 başlığı eklenir. 5 saniye sonra tekrar göndermeniz yeterlidir. Akış istekleri, akış bitene kadar eşzamanlı işleme slotunun birini işgal eder. Akışı açıp kapatmazsanız, eşzamanlı sınırına çok çabuk takılırsınız.
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("테스트 메시지"))
Eşzamanlı istekler sorun yaratıyorsa, yeniden denemeden çok çağrı tarafında semafor ile eşzamanlı sayısını sınırlamak daha iyidir. Yanıt başlıkları X-RateLimit-Limit-Requests ve X-RateLimit-Limit-Concurrency ile mevcut anahtarınızın sınırlarını kontrol edebilirsiniz. İstek gövdesi en fazla 8 MB olabilir. Başarısız veya reddedilen istekler için ücret alınmaz. Sorunları iletirken, yanıt başlığındaki X-Request-Id'yi de iletirseniz destek sayfası'nde nedenini bulmak daha kolay olur.
Kullanım kuralları ve dikkat edilmesi gereken sınırlar
Bu hizmet, yasal yetişkin kullanımını esas alarak, içerik reddi olmadan yanıt verecek şekilde ayarlanmış açık ağırlıklı bir modeli bağımsız bir işletmeci tarafından sunan bir API'dir. Meta, Mistral, Qwen, DeepSeek, OpenAI, xAI, Google, Anthropic vb. şirketlerin resmi API'si değildir ve istekleri birden fazla sağlayıcıya dağıtan bir yönlendirici de değildir. Sansürsüz bir AI API'si seçerken bu farkı bilmek, belgeler ile gerçek davranışları karıştırmamanızı sağlar.
- Reşit olmayanların dahil olduğu cinsel içerik hiçbir durumda izin verilmez. Bu sınır kaldırılmaz.
- Yalnızca metin desteği vardır. Görüntü, ses, video oluşturma, gömme (embedding) ve ince ayar (fine-tuning) hizmetleri sunulmaz.
- Gönderdiğiniz istemler model eğitimi için kullanılmaz. Ayrıntılar için Gizlilik Politikası'ne bakın.
Yanıtlarda reddiye bulunmaması, sorumluluk bulunmadığı anlamına gelmez. Hizmeti sağlayan taraf, kullanım koşullarına ve ilgili yasalara uymak zorundadır.
Maliyet algısı ve bakiye yükleme
Ücretler, girdi için 1 milyon token başına $0,15, çıktı için 1 milyon token başına $0,50'dir ve ön ödemeli krediden düşülür. Abonelik yoktur ve krediler sona ermez. Örneğin, girdisi 2.000 token ve çıktısı 500 token olan bir istek için girdi $0,0003 ve çıktı $0,00025 tutarında ücret yansır; toplam $0,00055 eder. 1.000 istek gönderdiğinizde toplam $0,55 ödersiniz.
Deneme kredisi $0,50 ile bu ölçekli istekleri yaklaşık 900 kez test edebilirsiniz. Yüklemeler $20 ile $500 arasında tam sayı tutarlarında yapılabilir; $50 üzeri yüklemelerde %5, $100 üzeri yüklemelerde %10 ve $200 üzeri yüklemelerde %15 bonus uygulanır. Ödeme yöntemleri USDT(TRC20) ve USDC(Base) şeklindedir. Detaylı tablo fiyatlandırma sayfası'nda yer almaktadır.
Daha fazla kılavuz
Sıkça sorulan sorular
OpenAI SDK kodunu ne kadar değiştirmeliyim?
Sadece base URL, API anahtarı ve model adını değiştirmeniz yeterlidir. Model ID'si uncensored, base URL ise https://api.mugeomyeolapi.com/v1'dir.
Deneme kredisi nasıl alınır?
Kayıt olduktan sonra API anahtarı sayfasındaki butona 1 kez tıklamanız halinde $0,50 verilir. Kişi başı 1 kez, geçerlilik süresi 7 gündür; ödeme bilgisi gerekmez.
429 hatası alıyorum, ne yapmalıyım?
Öncelikle hata kodunun rate_limited mi yoksa concurrency mi olduğunu kontrol edin. İlki dakikadaki istek sayısını aşmayı, ikincisi eşzamanlı istek sayısını aşmayı ifade eder. Retry-After başlığı varsa, belirtilen süre kadar bekleyip yeniden deneyin.
Görüntü de oluşturabilir miyim?
Hayır. Bu API yalnızca metin destekler; görüntü, ses, video oluşturma ve gömme (embedding) hizmetlerini desteklemez.
Uzun belgeleri tek seferde ekleyebilir miyim?
İstem ve çıktıyı birlikte 100.000 token'a kadar kullanabilirsiniz. İstek gövdesi boyutu 8 MB'ı geçmez.
API anahtarı sadece kayıt ile
Hesap oluşturma, anahtarı kopyalama, base URL değiştirme. Kurulum bu kadar tamamlanır.