مستندات کلید API Gemma

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

کلید API منحصر‌به‌فرد خود را برای احراز هویت هر درخواست استفاده کنید. URL پایه HTTPS://api.gemmaapikey.com/v1 است و کلید را در هدر Authorization ارسال می‌کنید. این با هر کلاینت سازگار با OpenAI کار می‌کند با تغییر base_url و کلید API. اگر آن را گم کردید، کلید جدیدی از داشبورد ایجاد کنید. کلید قدیمی بلافاصله از کار می‌افتد. خطاها و رد کردن‌ها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند.

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

درخواست POST را به /v1/chat/completions ارسال کنید و شناسه مدل را روی "uncensored" تنظیم کنید. دستور سیستم و پیام کاربر را در آرایه messages قرار دهید. مدل با متنی که بدون رد محتوا برای استفاده بزرگسالان قانونی تولید شده است، پاسخ می‌دهد.

Copyfrom openai import OpenAI

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

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

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

پکیج رسمی SDK OpenAI برای Node.js را نصب کنید. آن را با کلید API و URL پایه از این راهنما پیکربندی کنید. متد chat.completions.create را با پرامپت خود فراخوانی کنید.

Copyimport OpenAI from "openai";

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

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)

استریمینگ تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. همچنین به شما امکان می‌دهد پیشرفت را به صورت بلادرنگ به کاربران نمایش دهید. پنجره زمینه تا 100,000 توکن برای پرامپت و تکمیل به صورت ترکیبی پشتیبانی می‌کند.

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

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

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

خطاها و عیب‌یابی

خطای 401 به این معنی است که کلید API شما نامعتبر یا منقضی شده است. برای کلید فعال خود داشبورد را بررسی کنید. خطای 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. برای ادامه، از طریق ارزهای دیجیتال شارژ کنید. خطای 429 به این معنی است که به محدودیت نرخ رسیده‌اید. چند ثانیه صبر کنید و دوباره تلاش کنید.

خطاها از اعتبار شما مصرف نمی‌کنند. اگر شارژ دوباره رخ داد، از صفحه پشتیبانی برای رفع آن استفاده کنید. اعتبار منقضی نمی‌شود، بنابراین می‌توانید بعداً شارژ کنید.

cURL

Copycurl https://api.gemmaapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return the current system status"}]
  }'