مستندات API

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

ابتدا کلید خود را از طریق داشبورد تولید کنید. از URL پایه https://api.grokapipricing.com/v1 برای تمام درخواست‌ها. مقدار Authorization هدر به Bearer YOUR_API_KEY. این کلید واحد در تمام پایگاه‌های داده کار می‌کند. در صورت نیاز آزادانه آن را بچرخانید.

POST /v1/chat/completions

پرامپت‌های خود را به نقطه پایانی چت ارسال کنید. شناسه مدل همیشه uncensored. پارامترهایی مانند temperature یا top_p برای کنترل خ creativite. پاسخ‌ها تکمیل‌های چت استاندارد را با متادیتای مصرف توکن برمی‌گردانند. خطاهایی مانند 402 یا 429 نشان‌دهنده مشکلات پرداخت یا محدودیت نرخ است.

GET /v1/models

بررسی مدل‌های موجود با ارسال یک درخواست GET به نقطه پایانی مدل‌ها. شما خواهید دید که uncensored مدل فهرست شده است. این اتصال و موجودی مدل را تأیید می‌کند. این را برای اشکال‌زدایی پیکربندی‌های کلاینت قبل از ارسال پیکربندی‌های سنگین استفاده کنید.

استریمینگ و استفاده از SSE

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

فراخوانی تابع و حالت JSON

استفاده response_format با {"type": "json_object"} برای خروجی‌های JSON دقیق. فراخوانی تابع را با تعریف tools در درخواست شما. مدل از tool_choice برای اجرای اجباری یا خودکار اعمال کنید. این یکپارچه‌سازی قابل اعتماد با منطق بک‌اند شما را تضمین می‌کند.

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

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

cURL

Copycurl https://api.grokapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run query and return rows"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokapipricing.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);

جریان‌سازی

Copystream = 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)