fa ▾
دریافت کلید API

Grok limity API: شروع سریع راهنما

از API سازگار با OpenAI ما برای ارسال متن uncensored به یک مدل واحد بدون اشتراک‌های شرکتی یا هزینه‌های ماهانه استفاده کنید. این راهنما نحوه احراز هویت، streaming پاسخ‌ها و مدیریت خطاها را بدون هیچ آموزشی روی داده‌های شما نشان می‌دهد.

احراز هویت و URL پایه

ابتدا کلید API و URL پایه را در پیکربندی کلاینت خود تنظیم کنید. سرویس ما از هدرهای استاندارد استفاده می‌کند، بنابراین می‌توانید تنظیمات SDK موجود OpenAI خود را بدون بازنویسی منطق جایگزین کنید. شما یک کلید فعال به ازای هر حساب دریافت می‌کنید که در صورت نفوذ می‌توانید بلافاصله آن را مجدداً ایجاد کنید. URL پایه HTTPS://api.groklimity.com/v1 است و به میان‌افزار خاصی نیاز ندارد. به یاد داشته باشید که داده‌های پرامپت شما برای آموزش استفاده نمی‌شود، که حریم خصوصی پرامپت‌های اختصاصی شما را تضمین می‌کند.

ارسال اولین درخواست

درخواست POST را به /v1/chat/completions با شناسه مدل uncensored. این انتهای‌بند، پارامترهای استانداردی مانند temperature و stop توالی‌ها. می‌توانید اتصال را با یک پیام سیستم ساده برای بررسی تأخیر آزمایش کنید. خطاهایی مانند 401 کلید نامعتبر را نشان می‌دهند، در حالی که 402 به معنای تمام شدن اعتبار پیش‌پرداخت شما است. توجه که پنجره زمینه شامل 100,000 توکن برای ورودی و خروجی ترکیبی است.

curl https://api.groklimity.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the syntax error in the loop."}]
  }'

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

نصب رسمی openai بسته را پیکربندی کنید و آن را به URL پایه ما اشاره دهید. این به شما اجازه می‌دهد از روش‌های آشنای پایتون برای تماس‌های همگام یا ناهمگام استفاده کنید. مدل را روی uncensored برای اطمینان از اینکه به نقطه پایانی صحیح متصل می‌شوید. می‌توانید لیستی از پیام‌ها را دقیقاً مانند GPT-4 ارسال کنید. کتابخانه به‌طور خودکار شمارش توکن‌ها را مدیریت می‌کند، بنابراین از محدودیت‌های مصرف خود آگاه می‌مانید. نکته: استفاده max_tokens برای محدود کردن خروجی و جلوگیری از تخلیه غیرمنتظره اعتبار.

from openai import OpenAI

client = OpenAI(base_url="https://api.groklimity.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

کلاینت را با کلید API و URL پایه سفارشی مقداردهی اولیه کنید. توسعه‌دهندگان Node می‌توانند از رابط استاندارد chat.completions.create روش. این رویکرد به طور بی‌نقص با پروژه‌های موجودی که از کلاینت‌های OpenAI استفاده می‌کنند کار می‌کند. نیازی به بازنویسی ساختار درخواست‌های خود ندارید. SDK اتصال HTTP را مدیریت کرده و پاسخ‌های JSON را به طور کارآمد parse می‌کند. هشدار: اگر max_tokens, خروجی پیش‌فرض به ۲,۰۴۸ توکن محدود شده است.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.groklimity.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 در بدنه درخواست. این یک جریان رویدادهای ارسال‌شده توسط سرور (SSE) از توکن‌های جزئی برمی‌گرداند. می‌توانید متن را به صورت بلادرنگ هنگام تولید، رندر کنید که تاخیر ادراک‌شده را برای کاربران بهبود می‌بخشد. قطعه نهایی شامل آمار کل مصرف توکن برای صورتحساب است. این روش برای رابط‌های چت که کاربران انتظار بازخورد فوری دارند، ایده‌آل است. الزام: اطمینان حاصل کنید که کلاینت شما رویدادهای SSE را به درستی مدیریت می‌کند تا از نشت حافظه جلوگیری شود.

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 خطای نرخ محدودیت. بدنه درخواست‌ها به 8 MB محدود شده است که برای بیشتر تاریخچه‌های مکالمه استاندارد مناسب است. خطاها رایگان هستند، بنابراین درخواست‌های ناموفق اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند. مدل از فراخوانی ابزار و حالت JSON برای خروجی‌های ساختاریافته پشتیبانی می‌کند. محدودیت: فقط یک کلید فعال برای هر حساب وجود دارد، بنابراین کلیدها را با دقت جایگزین کنید.

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

آیا Grok بدون سانسور برای تولید کد قابل اعتماد است؟

مدل وظایف کدنویسی را به طور موثر مدیریت می‌کند اما کلود یا جیمینی نیست. این مدل در وظایف متن عمومی عالی است و یک جایگزین مقرون‌به‌صرفه برای استفاده سنگین ارائه می‌دهد. آن را با کدبیس خاص خود آزمایش کنید تا کیفیت خروجی را تأیید کنید.

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

شما فقط بابت چیزی که استفاده می‌کنید پرداخت می‌کنید، بدون اشتراک ماهانه. اعتبارها هرگز منقضی نمی‌شوند و می‌توانید از طریق ارز دیجیتال شارژ کنید و برای مبالغ بالاتر پاداش دریافت کنید. خطاها و رد شدن‌ها اعتبار شما را مصرف نمی‌کنند، بنابراین فقط بابت تکمیل‌های موفق پرداخت می‌کنید.

آیا می‌توانم از این API به عنوان جایگزینی برای کلید API grok استفاده کنم؟

بله، یک API سازگار با OpenAI است که کد کلاینت یکسانی را می‌پذیرد. تنها نیاز است URL پایه و شناسه مدل را به‌روزرسانی کنید. یک مدل بدون سانسور متمایز روی سرورهای ما اجرا می‌شود، نه سرویس رسمی Grok.

کلید API خود را دریافت کنید

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

دریافت کلید API