AR ▾
الحصول على مفتاح API

أول استدعاء لواجهة API الذكاء الاصطناعي غير الخاضعة للرقابة مع Open WebUI وOpenAI SDK

إذا كنت تستخدم API غير الخاضع للرقابة لأول مرة، فستحتاج فقط إلى مفتاح API وتغيير base URL. إذا كان لديك كود مكتوب بالفعل باستخدام OpenAI SDK، يمكنك تلقي الاستجابة الأولى بمجرد تغيير العنوان واسم النموذج.

تاريخ التحديث

رسم توضيحي ثلاثي الأبعاد يوضح توصيل موصل متوافق مع OpenAI ببوابة API لتدفق البيانات

ملخص رئيسي

  • يتمثل base URL في https://api.mugeomyeolapi.com/v1، ومعرف النموذج هو uncensored.
  • يدعم نقاط النهاية chat/completions وresponses وmodels، بالإضافة إلى البث المتدفق، واستدعاء الدوال، ووضع JSON.
  • ينقسم خطأ 429 إلى فئتين: rate_limited وconcurrency، ويتطلب كل منهما معالجة مختلفة حسب السبب.
  • النص فقط، ولا يُسمح بأي محتوى جنسي يتضمن القاصرين تحت أي ظرف من الظروف.

ما تحتاج إلى إعداده قبل البدء

تحتاجون إلى ثلاثة أشياء فقط: المفتاح، وBase URL، ومعرف النموذج. يتولى العميل المتوافق مع OpenAI الذي اعتدتم استخدامه باقي المهام.

  1. سجّلوا حسابًا. يمكن التسجيل باستخدام حساب Google أو البريد الإلكتروني وكلمة المرور.
  2. أنشئ المفتاح في صفحة إصدار مفتاح API. يمكن للمستخدمين الجدد الحصول على رصيد تجريبي بقيمة $0.50 بنقرة واحدة من هذه الصفحة. العرض لمرة واحدة لكل مستخدم، ساري لمدة 7 أيام، ولا يتطلب معلومات الدفع.
  3. عيّن عنوان URL الأساسي إلى https://api.mugeomyeolapi.com/v1، والنموذج إلى uncensored.

تتم المصادقة عبر رأس Authorization: Bearer <key> القياسي. لا تدرج المفتاح مباشرةً في الكود، بل احفظه في متغير بيئة. جميع الأمثلة أدناه تقرأ المتغير MUGEOMYEOL_API_KEY.

إجراء أول استدعاء باستخدام Python

بعد تثبيت حزمة openai (الإصدار 1 فأعلى)، ما عليك سوى تغيير 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)

يحتوي حقل usage في الاستجابة على عدد الرموز (tokens) المدخلة والمخرجة. تُحسب التكلفة بناءً على هذه الأرقام. يمكنك رؤية الرصيد المتبقي مباشرةً من خلال رأس الاستجابة X-Balance-USD. في حزمة Python، يمكنك الوصول إلى الرؤوس باستخدام 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)

أمثلة curl و Node.js

إذا كنت ترغب في التحقق فقط دون استخدام SDK، فإن curl هو الأسرع. وهو مفيد لفحص ما إذا كان المفتاح يعمل بشكل صحيح.

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.

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 ?? "");
}

يُفعّل البث المتدفق ببساطة عبر stream: true، ويتم إرساله عبر SSE. يمكنك التحقق من الاستخدام عند نهاية البث. تُعرض قائمة النماذج المتاحة عبر GET /v1/models. نظرًا لأن هذا الخدمة توفر نموذجًا واحدًا فقط وهو uncensored، فإن القائمة قصيرة.

الوسائط الأكثر استخدامًا

تعمل معظم الوسائط المستخدمة في OpenAI Chat Completions كما هي. فيما يلي ملخص لأهمها.

الوسيطالغرض
temperature، top_pالتحكم في عشوائية الإجابة. من الأسهل التنبؤ بالنتائج عند ضبط أحد الخيارين فقط بدلاً من تغيير كليهما بشكل كبير.
stop، seedتحديد سلسلة الإيقاف، محاولة ضمان إمكانية التكرار
عقوبة الحضور/التكرارقمع التكرار
max_tokensاختياري. عند حذفه، يمكن استخدام الجزء المتبقي من نافذة السياق.
tools، tool_choiceاستدعاء الدوال. تُعاد النتائج برسالة role: "tool".
response_formatيُفعّل وضع JSON عبر {"type":"json_object"}.

تبلغ نافذة السياق 100,000 رمز (token) مدمجة بين الموجّه والمخرجات. عند إدراج مستندات طويلة، تأكد من أن المدخلات لا تشغل معظم هذا الحد. عند استخدام وضع JSON، يكون الأمر أكثر استقرارًا إذا وضعت في الموجّه تعليمات بالرد بتنسيق JSON.

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)

بالإضافة إلى نقطة النهاية POST /v1/chat/completions، توجد أيضًا POST /v1/responses. إذا كنت تستخدم تنسيق Responses في الكود الجديد، يمكنك استدعاؤه باستخدام نفس عنوان URL الأساسي. تحقق من الحقول التفصيلية في وثائق API.

رموز الأخطاء ومعالجة إعادة المحاولة

الخطأ الذي ستواجهه أولاً هو HTTP 429. في هذه الخدمة، يحمل هذا الخطأ معنيين منفصلين.

  • rate_limited: تجاوزت عدد الطلبات المسموح بها في الدقيقة. المفتاح الرسمي يسمح بـ 300 طلب في الدقيقة، ومفتاح التجربة يسمح بـ 60 طلب في الدقيقة.
  • concurrency: عدد الطلبات المتزامنة التي تتم معالجتها في الوقت الحالي مرتفع جداً. المفتاح الرسمي يدعم 8 طلبات، والمفتاح التجريبي يدعم 2 طلبات.

يظهر خطأ 429 أيضًا عندما يكون الخادم مشغولاً مؤقتًا، ويُرسل مع رأس Retry-After: 5. يمكنك إعادة الإرسال بعد 5 ثوانٍ. تذكر أن طلبات البث المتدفق تشغل فتحة طلب متزامن واحدة حتى انتهاء البث. إذا فتحت البث ولم تغلقه، ستصل بسرعة إلى حد الطلبات المتزامنة.

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("테스트 메시지"))

إذا كانت الطلبات المتزامنة هي المشكلة، فمن الأفضل تقييد العدد باستخدام سيميافور (semaphore) في جانب الاستدعاء بدلاً من إعادة المحاولة. يمكنك التحقق من حدود مفتاحك الحالي عبر رؤوس الاستجابة X-RateLimit-Limit-Requests و X-RateLimit-Limit-Concurrency. حجم جسم الطلب محدود بـ 8MB كحد أقصى. الطلبات الفاشلة أو المرفوضة لا تُحسب عليها التكلفة. عند الاستفسار عن مشكلة، يسهل على فريق الدعم تحديد السبب إذا زودته برأس الاستجابة X-Request-Id.

قواعد الاستخدام والحدود المعروفة

تقدم هذه الخدمة API يديره مشغل مستقل لنموذج واحد مفتوح الأوزان، مُعد للرد دون رفض المحتوى، بافتراض الاستخدام القانوني للبالغين. إنه ليس API رسميًا من أي شركة مثل Meta أو Mistral أو Qwen أو DeepSeek أو OpenAI أو xAI أو Google أو Anthropic، وليس أيضًا راوترًا (router) يوزع الطلبات على نماذج من شركات متعددة. يجب أن تكون على علم بهذا الفرق عند اختيار API للذكاء الاصطناعي بدون رقابة، حتى لا تخلط بين الوثائق والسلوك الفعلي.

  • محتوى الجنس الذي يتعلق بالقاصرين غير مسموح به في أي حال من الأحوال. هذا الحد لا يمكن تجاوزه.
  • النص فقط. لا نقدم إنشاء الصور أو الصوت أو الفيديو، ولا التضمين (Embedding)، ولا الضبط الدقيق (Fine-tuning).
  • لا تُستخدم الموجّهات المدخلة في تدريب النموذج. لمزيد من التفاصيل، يرجى الرجوع إلى سياسة الخصوصية.

عدم وجود رفض في الإجابات لا يعني عدم وجود مسؤولية. يجب على مقدم الخدمة الالتزام بشروط الاستخدام والقوانين ذات الصلة.

إحساس التكلفة والشحن

التكلفة هي $0.15 لكل مليون رمز (token) مدخل، و$0.50 لكل مليون رمز (token) مخرج، وتُخصم من رصيد مسبق الدفع. لا توجد اشتراكات، والرصيد لا ينتهي. على سبيل المثال، طلب واحد يحتوي على 2,000 رمز مدخل و500 رمز مخرج يكلف $0.0003 للمدخلات و$0.00025 للمخرجات، بإجمالي $0.00055. إرسال 1,000 طلب سيكلف $0.55 فقط.

يمكنك تجربة حوالي 900 طلب بالحجم المذكور باستخدام رصيد التجربة بقيمة $0.50. الشحن متاح بمبالغ صحيحة تبدأ من $20 وتصل إلى $500، مع مكافآت بنسبة 5% للمبالغ فوق $50، و10% للمبالغ فوق $100، و15% للمبالغ فوق $200. وسائل الدفع المتاحة هي USDT(TRC20) وUSDC(Base). الجدول التفصيلي للأسعار موجود في صفحة الأسعار.

مزيد من الأدلة

الأسئلة الشائعة

كم يجب أن أعدل كود OpenAI SDK؟

ما عليك سوى تغيير ثلاثة أشياء: Base URL، ومفتاح API، واسم النموذج. معرف النموذج هو uncensored، و Base URL هو https://api.mugeomyeolapi.com/v1.

كيف أحصل على رصيد تجريبي مجاني؟

بعد التسجيل، اضغط على زر واحد في صفحة مفتاح API للحصول على رصيد بقيمة $0.50. العرض لمرة واحدة لكل مستخدم، لمدة 7 أيام، ولا يتطلب معلومات الدفع.

كيف أتصرف عند ظهور خطأ 429؟

تحقق أولاً مما إذا كان رمز الخطأ rate_limited (تجاوز حد المعدل) أم concurrency (تجاوز حد الطلبات المتزامنة). الأول يعني تجاوز عدد الطلبات في الدقيقة، والثاني يعني تجاوز عدد الطلبات المتزامنة. إذا كان هناك رأس Retry-After، انتظر المدة المحددة ثم أعد المحاولة.

هل يمكن إنشاء الصور أيضًا؟

لا. هذا API مخصص للنص فقط ولا يدعم إنشاء الصور أو الصوت أو الفيديو أو التضمين.

هل يمكن إدراج المستندات الطويلة دفعة واحدة؟

يمكنك استخدام ما يصل إلى 100,000 رمز (token) للموجّه والمخرجات معاً. حجم جسم الطلب يصل إلى 8MB كحد أقصى.

مفتاح API متاح بمجرد التسجيل

إنشاء الحساب، ونسخ المفتاح، وتغيير Base URL. هذه هي الإعدادات المطلوبة.

الحصول على مفتاح API
الحصول على مفتاح API