API

مستندات

همان‌طور که هست کار می‌کند. بدون آیین اضافه. Chat Completions سازگار با OpenAI. کلید را از حساب سایت یا ربات بگیرید: /api یا دکمه API.

Base URL · https://uncensored.dog/v1
نام سرویس قبلاً uncensored.monster بود. کلیدها همان است؛ فقط نشانی عوض شد.
API Key · حساب یا دکمه API در @uncensobot، یک بار نشان داده می‌شود
Model ID · پیش‌فرض z-ai/glm-5.3-flash-uncensored
پروتکل · Chat Completions، نه Anthropic و نه Responses

از کجا شروع کنید

  1. حساب یا @uncensobot را باز کنید. کلید، موجودی و پرداخت مشترک است.
  2. یک بسته بخرید ($1–$100، Crypto یا xRocket USDT). بدون موجودی → 402.
  3. دکمه API — راز یک بار نشان داده می‌شود. اگر از Telegram کپی کردید، فاصله و خط جدید آخر را بردارید.
  4. سه فیلد در کلاینت: Base URL با /v1، کلید، و شناسه دقیق مدل. بعد از عوض شدن نشانی یک گفتگوی تازه باز کنید.
  5. آزمایش: «با یک واژه جواب بده: آماده». اگر جواب آمد، کلاینت به ما وصل است.

بیشتر: ربات → کلید → API.

API چه می‌کند

کش بخشی از ورودی است: اگر usage مقدار cached_tokens بدهد، با قیمت کش مدل حساب می‌شود. کارت‌ها: خانه. برچسب منو به نسخه کلاینت بستگی دارد؛ هر سناریوی عامل را در هر IDE گواهی نکرده‌ایم.

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 تصویر می‌پذیرد؛ در Kilo‏ Anthropic را انتخاب نکنید.

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 جداست و لازم نیست به API ما بزند.

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 در همان IDEها: بخش بالا.

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 ادغام کنید (نسخه ۱ قالب دیگری دارد). کلید را در محیط نگه دارید. کلید شیء زیر models همان شناسه‌ای است که OpenCode به API می‌فرستد. 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
  }"

اگر جواب نمی‌دهد

چه چیزی وصل نمی‌شود

Claude Code و ANTHROPIC_BASE_URL نشانی را عوض می‌کنند نه پروتکل را: به Anthropic Messages نیاز دارند و ما آن را نمی‌دهیم. Codex پروتکل Responses می‌خواهد — آن هم نیست. GLM با عوض کردن کلاینت Claude یا GPT نمی‌شود. برای عامل از Cline، Roo، OpenCode یا Aider استفاده کنید.

کلید و موجودی در حساب یا Telegram است. مستندات: همین صفحه.

حساب کلید را از ربات بگیرید