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

uncensoredgrok.comالدليل

واجهة Grok API للمطوّرين: خيار متوافق مع OpenAI

إذا كنت تبحث عن واجهة grok API للمطوّرين، إليك ما تقدمه هذه الصفحة وما لا تقدمه. إنها واجهة نصية مستقلة ومتوافقة مع OpenAI، وليست خدمة xAI، وتعمل مع أي SDK لـ OpenAI.

تم التحديث

رسم توضيحي ثلاثي الأبعاد لواجهة LLM API للمطوّرين، يُظهر نافذة طرفية تبث كتل بيانات إلى مكعب خادم
uncensoredgrok.com2026-10-06

ما تحصل عليه، وما لا تحصل عليه

لنكن دقيقين منذ البداية، لأن اسم الموقع قد يُضلل. هذا ليس الـ API الرسمي لـ xAI أو لـ Grok. إنه API مستضاف أمام نموذج مفتوح الأوزان، تديره جهة مستقلة ومضبوط للإجابة بدون رفض المحتوى للاستخدام القانوني للبالغين. وهو ليس وسيطاً (router) عبر عدة موردين أيضاً. إذا كنت تحتاج نماذج xAI الخاصة بها، اذهب إلى xAI وتحقق من شروطها وأسعارها الحالية.

ما يصلح له هو سير عمل مباشر للمطورين. يتكلم الـ API بتنسيق إكمال المحادثة الخاص بـ OpenAI، لذا تبقى مكتبات العملاء التي تستخدمها تعمل. تغير قيمتين، وهي Base URL والمفتاح، وتمرر uncensored كـ model ID. توجد نقطتا نهاية: POST /v1/chat/completions و GET /v1/models. المصادقة هي رأس Authorization: Bearer القياسي.

الخدمة مخصصة للنصوص فقط. لا يوجد توليد صور أو صوت أو فيديو، ولا تضمين (embeddings)، ولا ضبط دقيق (fine-tuning). نافذة السياق 100,000 رمز، تُحسب عبر الموجّه والإكمال معاً، وmax_tokens اختياري. هناك حد محتوى صارم واحد: لا شيء يتضمن محتوى جنسي مع القاصرين، على الإطلاق.

إذا كان ذلك يتطابق مع ما تبنيه، يغطي باقي هذه الصفحة التفاصيل التي يطلبها المطورون: الطلب الأول، البث المتدفق، المخرجات المهيكلة، الأدوات، الحدود والتكلفة.

طلبك الأول

أنشئ حساباً من صفحة مفتاح API، انسخ المفتاح، وأرسل طلباً. يعمل تسجيل الدخول عبر Google أو عبر البريد الإلكتروني وكلمة المرور. يمكن للمستخدمين الجدد المطالبة بـ $0.50 من رصيد تجريبي مجاني بنقرة واحدة على تلك الصفحة، شخص واحد لكل حساب، صالح لمدة سبعة أيام. يعمل مفتاح التجربة تحت حدود أقل من المفتاح الكامل: طلبان متزامنان و60 طلباً في الدقيقة.

ابدأ بـ curl، لأنه يزيل كل المتغيرات الأخرى:

curl https://api.uncensoredgrok.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Explain idempotency keys in two sentences."}
    ]
  }'

نفس الاستدعاء مع الـ SDK الرسمي لـ Python:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.uncensoredgrok.com/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Explain idempotency keys in two sentences."}],
    temperature=0.7,
)
print(resp.choices[0].message.content)

يُعدّ استدعاء GET /v1/models طريقة رخيصة للتحقق من صحة مفتاحك وBase URL قبل تصحيح أي خطأ آخر. يحمل كل استجابة الرؤوس X-Request-Id، وX-Balance-USD، وX-RateLimit-Limit-Requests، وX-RateLimit-Limit-Concurrency. سجّل معرف الطلب مع سجلاتك الخاصة، وراقب رأس الرصيد إذا كنت تشغّل مهام دون إشراف.

تُمرَّر معاملات أخذ العينات مثل temperature، top_p، stop، seed وعقوبات التكرار والحضور إلى النموذج. توجد ملاحظات المعامل الكاملة في صفحة التوثيق.

البث المتدفق

عيّن stream: true، وتصل الاستجابة على شكل أحداث مرسَلة من الخادم (SSE)، بقطعة واحدة لكل مجموعة رموز، مع الإبلاغ عن الاستخدام في نهاية البث. بالنسبة لواجهة الدردشة، هذا هو الفرق بين شاشة تنتظر وشاشة تكتب.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a haiku about retries."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\ntokens:", chunk.usage)

في Node، النمط هو نفسه:

import OpenAI from "openai";

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

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about retries." }],
  stream: true,
});

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

تفاصيل مهمة لتخطيط السعة. يحتفظ الطلب المتدفق بمكان التزامن حتى ينتهي البث المتدفق. إذا فتح العميل تدفقاً ثم توقف، يظل هذا المكان مشغولاً، لذا أغلق التدفقات التي لم تعد تقرأها.

وضع JSON واستدعاء الدوال

للمخرجات المهيكلة، مرر response_format مع النوع json_object. قل أيضاً في الموجّه أنك تريد JSON، واذكر المفاتيح التي تتوقعها. يساعد وضع JSON النموذج على إنتاج نص قابل للتحليل، لكن يجب عليك التحقق من النتيجة في الكود الخاص بك ومعالجة فشل التحليل.

resp = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": "Reply with JSON only: {\"title\": string, \"tags\": [string]}"},
        {"role": "user", "content": "Summarize: a guide to rate limiting for API clients."},
    ],
)
import json
data = json.loads(resp.choices[0].message.content)

استدعاء الدوال

استدعاء الأدوات يتبع شكل OpenAI. ترسل tools و اختياريًا tool_choice. يجيب النموذج بـ tool_calls، تشغل الدالة، وترسل النتيجة كرسالة مع role: "tool". يمكن أيضاً بث استدعاءات الدوال.

import json

tools = [{
    "type": "function",
    "function": {
        "name": "get_order_status",
        "description": "Look up an order by id",
        "parameters": {
            "type": "object",
            "properties": {"order_id": {"type": "string"}},
            "required": ["order_id"],
        },
    },
}]

messages = [{"role": "user", "content": "Where is order A-1042?"}]
first = client.chat.completions.create(
    model="uncensored", messages=messages, tools=tools, tool_choice="auto"
)
msg = first.choices[0].message

if msg.tool_calls:
    messages.append(msg)
    for call in msg.tool_calls:
        args = json.loads(call.function.arguments)
        result = {"order_id": args["order_id"], "status": "shipped"}
        messages.append({
            "role": "tool",
            "tool_call_id": call.id,
            "content": json.dumps(result),
        })
    final = client.chat.completions.create(
        model="uncensored", messages=messages, tools=tools
    )
    print(final.choices[0].message.content)

قم دائماً بتحليل سلسلة الوسائط بشكل دفاعي. أحياناً تُرجع النماذج وسائط غير صالحة بصيغة JSON، وكتلة try/except حول json.loads مع محاولة إعادة واحدة هي تأمين رخيص.

حدود المعدل، أخطاء 429 وإعادة المحاولة

المفتاح الكامل يسمح بـ 8 طلبات متزامنة و300 طلب في الدقيقة. يسمح مفتاح التجربة بـ 2 و60. الحد الأقصى لحجم جسم الطلب هو 8 MB. عندما تتجاوز حداً، تحصل على HTTP 429، ويخبرك رمز الخطأ أي حد تم تجاوزه: rate_limited يعني طلبات كثيرة جداً في الدقيقة، concurrency يعني طلبات كثيرة جداً في وقت واحد. في حالة الحمل الزائد المؤقت، تُعيد الـ API أيضاً 429 مع رأس Retry-After: 5.

هذا يمنحك قاعدة إعادة محاولة بسيطة: على 429، انتظر Retry-After إذا كان موجوداً، وإلا استخدم التراجع الأسي مع العشوائية، وحد عدد المحاولات.

import time, random
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.uncensoredgrok.com/v1", api_key="YOUR_KEY", max_retries=0)

def ask(messages, attempts=5):
    for i in range(attempts):
        try:
            return client.chat.completions.create(model="uncensored", messages=messages)
        except RateLimitError as e:
            wait = float(e.response.headers.get("Retry-After", 2 ** i))
            time.sleep(wait + random.random())
    raise RuntimeError("still rate limited")

إذا كنت تشغل مهام دفع (batch jobs)، حدّ مجموعة العاملين الخاصة بك عند 8 على مفتاح كامل. ثمانية عمال يحمل كل منهم طلباً واحدًا هو الحد الأقصى، والتاسع سيجلب لك فقط أخطاء 429 برمز concurrency. الطلبات الفاشلة أو المرفوضة لا تُحسب، لذا فإن إعادة المحاولة لا تكلفك مالاً.

عادات توفر الوقت في الإنتاج

بعض الممارسات تجدي نفعاً بسرعة بمجرد نجاح الطلب الأول. احفظ المفتاح في متغير بيئة أو مدير أسرار، وأعط كل بيئة مفتاحها الخاص حتى تتمكن من تدوير واحد دون لمس الآخرين. سجّل قيمة X-Request-Id بجانب معرف التتبع الخاص بك؛ إذا بدا شيء ما خاطئاً في استجابة، فهذا المعرف هو ما يجب الاستشهاد به.

اضبط مهلة زمنية (timeout) على العميل. التوليد الطويل أمر شائع عندما تسمح بإكمال كبير، لذا اختر مهلة زمنية تناسب أطول إجابة متوقعة، واستخدم البث المتدفق لأي شيء ينتظره شخص. حد max_tokens في المسارات الموجهة للمستخدم حتى لو كان المعامل اختيارياً، لأن الحد يضع سقفًا لكل من زمن الاستجابة والإنفاق.

حافظ على سجل المحادثة الذي ترسله ضمن حدوده. نافذة السياق 100,000 رمز، لكن الإدخال يُحاسَب عليه في كل استدعاء، لذا فإن تقصير الأدوار القديمة أو تلخيصها هو أرخص تحسين يمكنك القيام به. أخيراً، ثبت إعدادات أخذ العينات. تعيين seed مع درجة حرارة ثابتة يمنحك عمليات تشغيل أكثر تكراراً عند مقارنة متغيرات الموجّه، على الرغم من أنه لا ينبغي أن تعتبرها ضماناً لمخرجات متطابقة.

التكلفة

التسعير هو $0.15 لكل مليون رمز إدخال و$0.50 لكل مليون رمز إخراج، من رصيد مسبق الدفع. لا يوجد اشتراك والرصيد لا ينتهي. مثال عملي يجعل الأمر ملموساً. خذ طلبًا يحتوي على 2,000 رمز إدخال و500 رمز إخراج:

  • الإدخال: 2,000 / 1,000,000 × $0.15 = $0.0003
  • الإخراج: 500 / 1,000,000 × $0.50 = $0.00025
  • المجموع: $0.00055 لكل طلب، لذا فإن 1,000 من هذه الطلبات تكلف $0.55.

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

لا تُستخدم الموجّهات للتدريب. إذا كنت تقارن ذلك بنقطة نهاية أخرى، فإن المقال الموجود على الدفع لكل رمز ونافذة السياق 100k يغطي كيفية تصرف نظام الفوترة في المحادثات الطويلة.

عندما يناسب خيار آخر بشكل أفضل

كن صادقًا بشأن مدى ملاءمة المنتج. إذا كنت بحاجة إلى توليد الصور، أو التضمينات (embeddings)، أو الكلام، أو نموذج مُعدّل بدقة (fine-tuned)، فإن هذه الـ API لا تقدمها. إذا تطلب عقدك أو فريق الامتثال وجود مورد من الطرف الأول، فاستخدم ذلك المورد. إذا كنت بحاجة إلى ضمان هوية النموذج القادم من مختبر معين، فهذا المنتج غير مناسب، لأنه يعمل بنموذج واحد مفتوح الأوزان مقدم من مورد مستقل.

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

أسئلة وأجوبة

uncensoredgrok.comأسئلة وأجوبة
هل هذا هو Grok API الرسمي؟

لا. إنها API متوافقة مع OpenAI ومستقلة، تعمل أمام نموذج واحد مفتوح الأوزان. لا تشغلها شركة xAI وليست موزعًا عبر عدة موردين.

أي معرّف نموذج أستخدم؟

استخدم uncensored كقيمة للنموذج في كل طلب. يؤدي طلب GET إلى /v1/models إلى سرد ما يمكن للمفتاح رؤيته.

هل يدعم البث المتدفق واستدعاء الدوال؟

نعم. يعمل البث المتدفق عبر بروتوكول SSE مع stream: true، ويدعم استدعاء الأدوات tools، وtool_choice، وtool_calls المتدفقة، مع إرسال النتائج كرسائل role: tool.

كيف أدفع؟

في هذا الموقع، يتم شحن الرصيد بالعملات المشفرة فقط، وهي USDT على شبكة TRC20 أو USDC على شبكة Base، بأي مبلغ صحيح يتراوح بين $20 و$500.

ما هي حدود المعدل؟

يتمتع المفتاح الكامل بقدرة على تنفيذ 8 طلبات متزامنة و300 طلب في الدقيقة. يحصل مفتاح التجربة على 2 و60 على التوالي. عند تجاوز الحد، تتلقى استجابة HTTP 429.

uncensoredgrok.com2026-10-06

مفتاحك على بُعد استمارة واحدة

أنشئ حساباً، وانسخ المفتاح، ثم غيّر عنوان URL الأساسي. هذه هي الإعدادات الكاملة.

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