API

التوثيق

يعمل مباشرة. بلا طقوس. Chat Completions متوافق مع OpenAI. خذ المفتاح من حساب الموقع أو البوت: /api أو زر API.

كيف تبدأ

1. افتح الحساب أو @uncensobot. المفتاح والرصيد والدفع مشتركة.
2. اشترِ باقة ($1–$100، Crypto أو xRocket USDT). لا رصيد → 402.
3. زر API — يُعرض السر مرة واحدة. أزل المسافات وسطرًا جديدًا في النهاية إن نسخت من Telegram.
4. ثلاثة حقول في العميل: Base URL مع /v1، والمفتاح، ومعرّف النموذج الكامل. محادثة جديدة بعد تغيير العنوان.
5. اختبار: «أجب بكلمة واحدة: جاهز». إذا وصل رد، فالعميل يصل إلينا.

المزيد: البوت → المفتاح → API.

ماذا تفعل الواجهة

• GET /v1/models — الكتالوج؛ أرسل Authorization: Bearer. لا مفتاح → 401. لا كتالوج عام بلا مصادقة.
• POST /v1/chat/completions — نص وصور (image_url) وتدفق. يُقبل max_tokens وmax_completion_tokens. البوابة تمرّر tools وtool_choice وparallel_tool_calls. إن لم يستطع المزوّد تشغيل الأدوات، يصلك خطأ المصدر.
• يجب أن يكون معرّف النموذج من القائمة أدناه. model الفارغ يستخدم GLM Flash. مُحدّد Telegram لا يغيّر الواجهة.
• في العميل اضبط نافذة السياق 1048576 وميزانية الإخراج 16384 (أو max_tokens / max_completion_tokens الخاص بك). هذا يسقف ردًا واحدًا، لا الخيط كله.
• موجه النظام والسجل والأدوات يتشاركون هذه النافذة.
• جسم الطلب حتى 32 ميبي بايت. أكبر → 413.
• قبل الاستدعاء نحجز تقدير الإدخال زائد ميزانية الإخراج (max_tokens / max_completion_tokens، وإلا 16384) بسعر النموذج. إن لم يتسع الحجز في الرصيد المتاح — 402. بعد الرد نخصم الاستخدام الفعلي ونحرر الباقي. الحجز العالق ينتهي بعد 20 دقيقة.
• لا نخدم Anthropic Messages ولا OpenAI Responses ولا التضمينات ولا FIM.
• لا تُعد المحاولة إن بدأ التدفق: هذا طلب مدفوع ثانٍ. للدعم أرسل الوقت وX-Request-ID، لا المفتاح.
• لا تُضف /chat/completions إلى Base URL — العميل يفعل ذلك.

الذاكرة المؤقتة جزء من الإدخال: إن أبلغ usage عن cached_tokens تُحسب بسعر ذاكرة النموذج. البطاقات: الرئيسية. تسميات القائمة تعتمد على إصدار العميل؛ لم نُصادق كل سيناريو وكيل في كل بيئة.

• z-ai/glm-5.3-flash-uncensored الافتراضي. دردشة وكتابة ورمز.
• abliteration-ai/abliterated-model-large-v2 الأذكى والأسرع.
• abliteration-ai/abliterated-model-large-flash نموذج Abliterated سريع مبني على DeepSeek Flash.
• qwen/qwen3.8-27b-uncensored دردشة ورمز، والاستدلال اختياري.
• qwen/qwen3.8-27b-uncensored:thinking استدلال، ومهام متعددة الخطوات.
• pqhaz/DeepSeek-V4.1-Flash-1017-heretic:thinking DeepSeek Flash سريع، والاستدلال يعمل دائمًا.
• abliteration-ai/abliterated-model نص قصير ويومي.
• Gemma-4-31B-Gembrain-uncensored-heretic حوار وكتابة وتحليل.
• z-ai/glm-5.3-uncensored GLM 5.3 الكامل، تجريبي، نص فقط.
• xiaomi/mimo-v2.6-flash-uncensored MiMo نصي، والاستدلال اختياري.
• xiaomi/mimo-v2.6-flash-uncensored:thinking MiMo والاستدلال يعمل دائمًا، والرد أبطأ.

ZCode

1. في البوت افتح API وأنشئ مفتاحًا باسم واضح، مثل zcode.
2. ثبّت أو حدّث ZCode من zcode.z.ai.
3. Settings → Model Settings. أو اضغط اسم النموذج تحت حقل الإدخال → Manage Models.
4. أسفل القائمة — Add Provider. أي اسم، مثل uncensored.
5. OpenAI Base URL: https://uncensored.dog/v1. اترك Anthropic Base URL فارغًا.
6. التنسيق: Chat completions. الصق المفتاح. إن رأيت «API Key Required» ففعّله. Save.
7. Add Model، المعرّف حرفيًا qwen/qwen3.8-27b-uncensored. اسم العرض لك.
8. الإعداد المتقدم لهذا النموذج: Context Window 1048576، Max output tokens 16384.
9. فعّل المفتاح عند المزوّد وعند النموذج. في الدردشة اختر نموذجًا من هذه المجموعة، لا GLM المدمج من Z.ai.
10. مهمة جديدة واختبار قصير مثل «أجب بكلمة واحدة: جاهز».

لا تلصق المفتاح في بطاقة Z.ai / BigModel — تذهب إلى /paas/v4 ولن تعمل. لا تُضف اللاحقة [1m] إلى معرّف النموذج.

Cursor

1. Settings → Models → API Keys / OpenAI compatible (الصياغة تعتمد على الإصدار).
2. Override OpenAI Base URL: https://uncensored.dog/v1. اترك Anthropic Base URL فارغًا.
3. المفتاح من البوت. النموذج: qwen/qwen3.8-27b-uncensored، بلا لاحقة [1m].
4. دردشة وكيل جديدة بعد تغيير العنوان. الخيوط القديمة قد تحتفظ بالعنوان السابق.

Cursor Tab ونماذج Cursor المدمجة تتبع شروط Cursor، لا مفتاحنا. التفاصيل: Base URL خاص في Cursor. من طرفية Cursor يمكنك تشغيل Aider أيضًا — عميل منفصل.

Roo Code (VS Code)

1. لوحة Roo → API Provider → OpenAI Compatible.
2. Base URL والمفتاح ومعرّف النموذج كما أعلاه. Context Window 1048576، Max Output Tokens 16384.
3. فعّل Image Support إن احتجت الصور. لا تُفعّل Computer Use كقدرة للنموذج — الرؤية لا تضيفه.
4. حقول السعر في Roo لواجهة الإضافة فقط. الخصم دائمًا حسب أسعارنا (GLM إدخال $0.39 / إخراج $1.58 / ذاكرة $0.16 لكل 1M).
5. ابدأ بمهمة صغيرة وملف واحد. يستخدم Roo أدوات tools الأصلية.

Cline (VS Code)

1. Cline → Settings → API Provider: OpenAI Compatible.
2. Base URL والمفتاح ومعرّف النموذج. إن كان لـ Plan وAct مزوّدان منفصلان، املأهما بالطريقة نفسها.
3. Model Configuration: Max Output Tokens 16384، Context Window 1048576، Image Support إن لزم الصور.
4. طلب قصير. تعليمات النظام والسجل والأدوات يتشاركون هذه النافذة.

Kilo Code (VS Code)

1. Settings → Providers → Custom provider. أي معرّف، مثل uncensored.
2. Provider API: OpenAI Compatible. Base URL والمفتاح ومعرّف النموذج. Save.
3. في kilo.jsonc للنموذج: limit.context = 1048576، limit.output = 16384. اختر هذا المزوّد في قائمة النماذج.
4. Chat Completions فقط. يقبل GLM الصور؛ لا تختر Anthropic في Kilo.

Continue (VS Code / JetBrains)

VS Code: إضافة Continue → ملف config.yaml المحلي. JetBrains: Settings → Plugins → Continue، ملف النموذج نفسه. إن وُجد إعداد، ادمج مدخل models فقط.

models:
  - name: GLM 5.3 Flash Uncensored
    provider: openai
    model: qwen/qwen3.8-27b-uncensored
    apiBase: https://uncensored.dog/v1
    apiKey: YOUR_KEY
    roles:
      - chat
      - edit
    defaultCompletionOptions:
      maxTokens: 16384

الدردشة وEdit يعملان. الإكمال التلقائي والفهرسة عبر التضمينات لا يعملان — نحن لا نقدّم تضمينات.

Zed

1. الأمر zed: open settings file — أضف المزوّد في settings.json من دون مسح الباقي.
2. الأمر agent: open settings — الصق المفتاح في واجهة المزوّد، لا في JSON.
3. في لوحة الذكاء اختر GLM وأرسل نصًا قصيرًا.

{
  "language_models": {
    "openai": {
      "api_url": "https://uncensored.dog/v1",
      "available_models": [
        {
          "name": "qwen/qwen3.8-27b-uncensored",
          "display_name": "GLM 5.3 Flash Uncensored",
          "max_tokens": 1048576,
          "max_output_tokens": 16384
        }
      ]
    }
  }
}

في Zed‏ max_tokens نافذة السياق؛ max_output_tokens ميزانية الرد. Edit Prediction منفصل ولا يلزم أن يضرب واجهتنا.

JetBrains AI Assistant

1. Settings → Tools → AI Assistant → Providers & API keys.
2. مزوّدو ذكاء خارجيون → OpenAI-compatible. URL ‏https://uncensored.dog/v1، المفتاح من البوت. اضغط Test Connection.
3. في AI Chat اختر GLM. اختياري: Model Assignment → Core features، السياق 1048576.

هذا يغطي الدردشة وتوليد الكود. هذا لا يستبدل اشتراك JetBrains ولا كل وكيل مدمج. Continue في بيئات التطوير نفسها: القسم أعلاه.

Aider

الطرفية في مجلد المشروع (VS Code وCursor وJetBrains — نفس الشيء). البادئة openai/ تخبر Aider أي بروتوكول يستخدم. قد يظهر تحذير «unknown model» — انسخ المعرّف كاملًا. لا تُلقِ المستودع كله: /add ملفًا صغيرًا ثم صف التعديل.

export OPENAI_API_BASE=https://uncensored.dog/v1
export OPENAI_API_KEY=YOUR_KEY
aider --model openai/qwen/qwen3.8-27b-uncensored

PowerShell: ‏$env:OPENAI_API_BASE و$env:OPENAI_API_KEY.

OpenCode 2

ادمج هذا المزوّد في opencode.jsonc (الإصدار 1 بصيغة مختلفة). أبقِ المفتاح في متغير البيئة. مفتاح الكائن تحت models هو المعرّف الذي يرسله OpenCode إلى الواجهة. name مجرد تسمية في القائمة. اسم مستعار مثل glm يعيد 400 «Unknown model». في /models اختر uncensored/z-ai/glm-5.3-flash-uncensored. ابدأ بمهمة صغيرة.

إن ظهر النموذج وقال الدردشة «no API key» أو «invalid key»، فالمتغير UNCENSORED_API_KEY غير مضبوط غالبًا: القيمة الفارغة تُرسل كمفتاح فارغ. اضبطها في الطرفية نفسها التي تشغّل منها opencode. PowerShell: ‏$env:UNCENSORED_API_KEY="sk-..."، bash: ‏export UNCENSORED_API_KEY=sk-.... تحقق من المفتاح: curl.exe https://uncensored.dog/v1/models -H "Authorization: Bearer $env:UNCENSORED_API_KEY" يجب أن يعيد قائمة النماذج.

{
  "provider": {
    "uncensored": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "uncensored.dog",
      "options": {
        "baseURL": "https://uncensored.dog/v1",
        "apiKey": "{env:UNCENSORED_API_KEY}"
      },
      "models": {
        "z-ai/glm-5.3-flash-uncensored": {
          "name": "GLM 5.3 Flash",
          "limit": { "context": 1048576, "output": 16384 }
        }
      }
    }
  }
}

Python وNode

أبقِ المفتاح على الخادم، لا في JS المتصفح أبدًا. لا تستدعِ client.responses.create — هذا 404.

from openai import OpenAI
client = OpenAI(
    api_key="YOUR_KEY",
    base_url="https://uncensored.dog/v1",
)
r = client.chat.completions.create(
    model="qwen/qwen3.8-27b-uncensored",
    messages=[{"role": "user", "content": "ping"}],
    max_tokens=32,
)
print(r.choices[0].message.content)

التدفق: stream=True، اقرأ chunk.choices[0].delta.content. التثبيت: python -m pip install openai.

const r = await fetch("https://uncensored.dog/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNCENSORED_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen/qwen3.8-27b-uncensored",
    messages: [{ role: "user", content: "ping" }],
    max_tokens: 32,
  }),
});
const data = await r.json();
if (!r.ok) throw new Error(data.error?.message || r.status);
console.log(data.choices[0].message.content);

أي وكيل آخر متوافق مع OpenAI (Hermes وما شابه) يستخدم الحقول الثلاثة نفسها: Base URL مع /v1، والمفتاح، ومعرّف النموذج.

فحص cURL

curl https://uncensored.dog/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"qwen/qwen3.8-27b-uncensored\",
    \"messages\": [{\"role\": \"user\", \"content\": \"ping\"}],
    \"max_tokens\": 32
  }"

إذا لم يرد

• 401 — مفتاح مفقود أو خطأ أو مسافة أو سطر جديد أو مفتاح مُلغى. أصدر واحدًا جديدًا في الحساب أو البوت.
• 402 — لا رصيد. اشحن في الحساب أو البوت؛ max_tokens الكبير لا يغني عن الشحن.
• 400 — model خاطئ أو JSON تالف. انسخ المعرّف كاملًا، بلا [1m].
• 413 — الجسم أكبر من 32 ميبي بايت (سجل أو صورة). صغّر المرفق: PNG/JPEG، لا ملفًا ضخمًا.
• 404 — Base URL بلا /v1، أو العميل يضرب Anthropic / Responses / التضمينات / FIM.
• 429 — طلبات متزامنة كثيرة (3 لكل مفتاح). انتظر؛ لا تُكرر الطلبات المدفوعة في حلقة.
• 503 — عطل مؤقت. انتظر؛ لا تُعد المحاولة فورًا.
• رد مقطوع، finish_reason: length — ارفع ميزانية الإخراج أو افتح محادثة جديدة أو قسّم المهمة. اطلب التوليد الطويل بالتدفق.
• انتهت المهلة — تدفق أو مهمة أقصر أو مهلة أكبر في العميل.
• الصور: يقبلها GLM؛ قد لا يُرفق العميل الملفات. ابدأ بملف PNG/JPEG صغير.
• في ZCode مفتاح صف النموذج مطفأ — لن يخرج الطلب.

ما الذي لا يتصل

Claude Code وANTHROPIC_BASE_URL يغيّران العنوان لا البروتوكول: يحتاجان Anthropic Messages، ونحن لا نقدّمه. يريد Codex بروتوكول Responses — وهو غير موجود أيضًا. لا يصبح GLM‏ Claude أو GPT لأنك بدّلت العميل. للوكيل استخدم Cline أو Roo أو OpenCode أو Aider.

المفاتيح والرصيد في الحساب أو في Telegram. التوثيق: هذه الصفحة.