Gemma api key documentation

المصادقة وURL الأساسي

استخدم مفتاح API الفريد الخاص بك لمصادقة كل طلب. عنوان URL الأساسي هو HTTPS://api.gemmaapikey.com/v1 وترسل المفتاح في رأس Authorization. يعمل هذا مع أي عميل متوافق مع OpenAI من خلال تغيير base_url ومفتاح API. إذا فقدته، أنشئ مفتاحاً جديداً من لوحة التحكم. يتوقف المفتاح القديم عن العمل فوراً. لا تستهلك الأخطاء والرفض رصيدك المدفوع مسبقاً.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions مع معرف النموذج "uncensored". ضمّن رسالة النظام ورسالة المستخدم في مصفوفة الرسائل. يستجيب النموذج بنص مُولّد دون رفض المحتوى للمحتوى البالغ القانوني.

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) شرائح أحداث الإرسال من الخادم (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 رمز للمدخلات والإكمال معاً.

حدود المعدلات والسياق

يُسمح لك بإرسال 300 طلبًا في الدقيقة لكل مفتاح. يمكن تشغيل 8 طلبات فقط في وقت واحد. يجب ألا يتجاوز جسم الطلب 8 ميجابايت. تضمن هذه الحدود أداءً مستقرًا لجميع المستخدمين.

يدعم النموذج استدعاء الوظائف، ووضع JSON، والمعلمات القياسية مثل seed و presence_penalty. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب. إذا لم تضبط max_tokens، فإنه يفتراضي إلى 2,048.

الأخطاء واستكشاف الأخطاء وإصلاحها

يشير خطأ 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"}]
  }'