fa ▾

مستندات API

API کدنویسی بدون سانسور را با تغییر URL پایه SDK سازگار با OpenAI خود به URL ما و احراز هویت با کلید API پیش‌پرداخت خود شروع کنید.

تنظیم URL پایه احراز هویت

ابتدا اعتبارنامه خود را روی دریافت کلید API صفحه را با استفاده از حساب گوگل یا ایمیل باز کنید. سیستم کلید شما را بلافاصله نمایش می‌دهد و می‌توانید هر زمان آن را جایگزین کنید تا دسترسی لغو شود. تمام درخواست‌ها به /v1 نقطه پایانی ساختار. نیازی به پیکربندی هدرهای پیچیده ندارید، فقط کلید را در هدر Authorization عبور دهید.

کلید API هوش مصنوعی بدون سانسور ما با هر کتابخانه‌ای که کلاینت‌های سازگار با OpenAI را پشتیبانی کند کار می‌کند. URL پایه را به HTTPS://api.glmkey.com/v1 تغییر دهید و توکن خود را تزریق کنید. این پیکربندی یکپارچه‌سازی‌های استاندارد را بازتاب می‌دهد و تضمین می‌کند که کد موجود شما بدون قفل‌شدگی با فروشنده به درستی مسیریابی شود.

  • URL پایه: HTTPS://api.glmkey.com/v1
  • هدر Auth: Authorization: Bearer YOUR_API_KEY

مرجع نقطه پایانی تکمیل چت

متن را به مدل ارسال کنید با پست کردن JSON به نقطه پایانی تکمیل‌های چت. API یک پیکربندی استاندارد با نام مدل، آرایه پیام‌ها و پارامترهای اختیاری را انتظار دارد. شما باید uncensored به عنوان شناسه مدل تا اطمینان حاصل کنید که به مدل زبانی بزرگ مناسب برای خروجی بدون محدودیت دسترسی دارید.

خطاهایی مانند ۴۰۱ نشان‌دهنده کلید نامعتبر است، در حالی که ۴۰۲ نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. سیستم فقط برای مصرف واقعی توکن‌ها هزینه دریافت می‌کند، بنابراین خطاهای دریافتی از موجودی شما کسر نمی‌شوند. برای آزمایش اتصال، از دستور curl زیر استفاده کنید.

curl https://api.glmkey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the endpoints for the glm key service"}]
  }'

یکپارچه‌سازی SDK پایتون

کتابخانه رسمی OpenAI را نصب کنید و آن را طوری پیکربندی کنید که به URL پایه ما اشاره کند. این به شما اجازه می‌دهد از الگوهای آشنا پایتون برای تولید متن استفاده کنید. کلاینت سریال‌سازی و تلاش مجدد را به‌طور خودکار مدیریت می‌کند. می‌توانید پارامترهایی مانند temperature یا top_p برای کنترل خلاقیت.

LLM بدون سانسور فرمت‌های پیام استاندارد را می‌پذیرد. شما می‌توانید بین نقش‌های system، user و assistant مانند هر ارائه‌دهنده دیگری جابجا شوید. قطعه کد Python زیر یک درخواست تکمیل پایه را نشان می‌دهد.

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

یکپارچه‌سازی Node SDK

از SDK Node.js برای یکپارچه‌سازی کلید API در پروژه‌های JavaScript یا TypeScript خود استفاده کنید. تنظیم apiKey و baseURL properties در پیکربندی کلاینت. این تضمین می‌کند که تمام درخواست‌ها به سرورهای ما هدایت شوند به جای ارائه‌دهنده پیش‌فرض. سپس می‌توانید chat.completions.create() با پارامترهای مورد نظر خود.

API کدنویسی بدون سانسور از تعریف‌های ابزار استاندارد و حالت‌های JSON پشتیبانی می‌کند. می‌توانید پاسخ‌ها را مستقیماً در منطق برنامه خود تجزیه کنید. مثال Node.js زیر نحوه راه‌اندازی کلاینت و ارسال یک پیام ساده را نشان می‌دهد.

import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

پاسخ‌های استریم‌شده و تعداد توکن‌ها

استریمینگ را با تنظیم stream: true در درخواست شما. API قطعه‌های رویدادهای ارسالی سرور (SSE) را برمی‌گرداند. هر قطعه محتوای جزئی دارد و قطعه نهایی شامل کل مصرف توکن است. این به شما امکان می‌دهد متن را به صورت تدریجی در رابط کاربری خود رندر کنید.

کلید API هوش مصنوعی بدون سانسور این ویژگی را بدون هزینه اضافی پشتیبانی می‌کند. می‌توانید مصرف توکن‌ها را به صورت بلادرنگ نظارت کنید. قطعه کد زیر نحوه مدیریت پاسخ‌های استریم را در Python نشان می‌دهد.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

قوانین محدودیت‌های نرخ و همزمانی

شما به ۳۰۰ درخواست در دقیقه به ازای هر کلید محدود هستید. همزمانی به ۸ درخواست همزمان محدود شده است. بدنه درخواست نباید از ۸ مگابایت تجاوز کند. این محدودیت‌ها عملکرد پایدار را برای همه کاربران پیش‌پرداخت تضمین می‌کنند. اگر نرخ را تجاوز کنید، خطای 429 دریافت می‌کنید.

پنجره زمینه تا ۱۰۰,۰۰۰ توکن برای مجموع ورودی و خروجی پشتیبانی می‌کند. خروجی به ۱۶,۰۰۰ توکن در هر درخواست محدود است. اگر تنظیم نکنید max_tokens, پیش‌فرض ۲,۰۴۸ توکن است. برای جلوگیری از اختلال در خدمات، مصرف خود را از طریق داشبورد پایش کنید.

سوالات متداول

چگونه اولین بار کلید glm خود را دریافت کنم؟

در صفحه دریافت کلید API با حساب گوگل یا ایمیل ثبت‌نام کنید. سیستم کلید شما را بلافاصله پس از ثبت‌نام نمایش می‌دهد. نیازی به شماره تلفن نیست و ۰.۵۰ دلار اعتبار آزمایشی به مدت ۷ روز دریافت می‌کنید.

اگر از محدودیت 300 درخواست در دقیقه عبور کنم چه اتفاقی می‌افتد؟

API خطای 429 Too Many Requests (درخواست‌های بیش از حد) را برمی‌گرداند. باید منتظر بمانید تا پنجره محدودیت نرخ (rate limit) بازنشانی شود. هم‌زمانی نیز به ۸ درخواست هم‌زمان در هر کلید محدود شده است.

آیا مدل بدون سانسور همانند GPT یا Claude است؟

خیر. این یک مدل وزن‌باز است که روی سرورهای خودمان اجرا می‌شود و برای پاسخ‌دهی بدون رد محتوای قانونی بزرگسالان بهینه‌سازی شده است. نه GPT، نه Claude، نه Gemini، نه Grok، نه DeepSeek، نه Qwen، نه Llama و نه مدل هیچ فروشنده دیگری است.

کلید خود را همین حالا ایجاد کنید

ثبت‌نام کنید، کلید را کپی کنید، URL پایه را به‌روزرسانی کنید. این پیکربندی کامل است.