مستندات API هوش مصنوعی Grok

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

ابتدا کلید API خود را از طریق داشبورد یا با استفاده از Google تولید کنید.

کلاینت خود را به https://api.grokaiapi.com/v1 و کلید را در Authorization header. این URL پایه با هر SDK سازگار با OpenAI کار می‌کند و به شما امکان می‌دهد مدل بدون سانسور ما را بدون بازنویسی منطق یکپارچه‌سازی خود جایگزین کنید.

Endpoint /v1/chat/completions

درخواست‌های POST را به /v1/chat/completions برای دریافت پاسخ‌های متنی فوری.

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

Copycurl https://api.grokaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current version of the model?"}]
  }'

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

از SDK رسمی پایتون برای مدیریت درخواست‌ها با حداقل کد استفاده کنید.

URL پایه و کلید API را پیکربندی کنید، سپس نقطه پایانی تکمیل‌های چت را فراخوانی کنید. این رویکرد کد شما را تمیز نگه می‌دارد و به شما امکان می‌دهد بر ساخت ویژگی‌های برنامه خود تمرکز کنید تا اینکه به‌طور دستی مدیریت اتصالات HTTP.

Copyfrom openai import OpenAI

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

ادغام را در Node.js با تنظیم صحیح متغیرهای محیطی پیاده‌سازی کنید.

SDK چرخه حیات درخواست را به صورت خودکار مدیریت می‌کند که افزودن LLM uncensored ما به سرویس‌های بک‌اند شما را آسان می‌سازد. می‌توانید تاریخچه مکالمه و پنجره زمینه را مستقیماً از طریق ساختارهای آرایه استاندارد مدیریت کنید.

Copyimport OpenAI from "openai";

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

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)

محدودیت‌ها، خطاها و زمینه

API ما از یک پنجره زمینه ۱۰۰,۰۰۰ توکن برای مکالمات طولانی‌مدت پشتیبانی می‌کند.

خطاهایی مانند 401 برای کلیدهای نامعتبر، 402 برای اعتبار ناکافی و 429 برای محدودیت نرخ را مدیریت کنید. شما به 300 درخواست در دقیقه و 8 درخواست همزمان به ازای هر کلید محدود هستید. حجم بدنه درخواست‌ها را زیر 8 MB نگه دارید تا عملکرد روانی تضمین شود.