شروع سریع API Groq

پیش‌نیازها و وابستگی‌ها

ابتدا کلید API groq خود را از داشبورد تولید کنید. می‌توانید با Google وارد شوید یا از ایمیل و رمز عبور استفاده کنید. نیازی به شماره تلفن نیست. کلید بلافاصله برای کپی و پیست ظاهر می‌شود.

اطمینان حاصل کنید که محیط شما از SDKهای رسمی OpenAI پشتیبانی می‌کند. URL پایه ما HTTPS://api.apigroq.com/v1 است. این با هر کلاینتی که نقاط پایانی استاندارد OpenAI را می‌پذیرد کار می‌کند. نیازی به نصب میان‌افزار اضافی ندارید.

احراز هویت کلید API groq شما

کلید خود را به عنوان توکن Bearer در هدر Authorization ارسال کنید. این هر درخواست به سرویس AI بدون سانسور را احراز هویت می‌کند. اگر کلید نامعتبر باشد، خطای 401 دریافت می‌کنید. اگر اعتبار کافی نداشته باشید، خطای 402 دریافت می‌کنید.

• هدر: Authorization: Bearer YOUR_API_KEY
• کلیدها را در کدهای سمت کلاینت قرار ندهید.

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

یک درخواست POST به /v1/chat/completions. از شناسه مدل uncensored. این مدل برای استفاده قانونی بزرگسالان بدون رد محتوا پاسخ می‌دهد. تنظیم top_p to 1 and temperature to 0 for consistent results.

Copycurl https://api.apigroq.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies in requirements.txt"}]
  }'

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

مدیریت پاسخ‌های جریان‌سازی

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

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)

این رویکرد تأخیر ادراک‌شده را برای پاسخ‌های بزرگ کاهش می‌دهد. کلاینت شما باید data: prefix و اشیاء JSON را parse کنید.

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

پکیج رسمی پایتون OpenAI را نصب کنید. کلاینت را با URL پایه و کلید خود پیکربندی کنید. این امکان استفاده مستقیم از LLM بدون سانسور را بدون نیاز به OpenRouter فراهم می‌کند.

Copyfrom openai import OpenAI

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

SDK تلاش مجدد و تجزیه JSON را به صورت خودکار مدیریت می‌کند. همچنین می‌توانید حالت JSON را با تنظیم response_format به {"type": "json_object"}.

Node SDK و محدودیت‌ها

از کلاینت OpenAI Node.js به طور مشابه استفاده کنید. URL پایه را به نقطه پایانی ما تنظیم کنید. محدودیت‌های نرخ خود را به دقت پایش کنید.

Copyimport OpenAI from "openai";

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

شما محدود به ۳۰۰ درخواست در دقیقه به ازای هر کلید هستید. می‌توانید ۸ درخواست همزمان داشته باشید. حجم بدنه درخواست باید کمتر از ۸ مگابایت باشد. پنجره متن ۱۰۰,۰۰۰ توکن به طور کلی است. حداکثر خروجی ۱۶,۰۰۰ توکن است مگر اینکه خلاف آن مشخص شود.