Gemma api Quickstart Guide

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

ابدأ بإنشاء المفتاح الخاص بك على لوحة التحكم. استخدم عنوان URL الأساسي المقدم لتوجيه الطلبات إلى النموذج غير الخاضع للرقابة الخاص بنا. تعتمد المصادقة على رأس قياسي.

عنوان URL الأساسي: HTTPS://api.apigemma.com/v1

رأس: Authorization: Bearer YOUR_API_KEY

مفتاح نشط واحد فقط لكل حساب. يؤدي استبداله إلى إلغاء سريان القديم على الفور. لا يُطلب رقم هاتف للتسجيل.

نقطة نهاية إكمال الدردشة

أرسل مطالبات نصية إلى نقطة إكمال الدردشة. يعيد النموذج نصاً بدون رفض للمحتوى للاستخدام القانوني للبالغين.

نافذة السياق: 100,000 رمز. الحد الأقصى للإخراج: 16,000 رمز. الأخطاء والرفض لا تكلف شيئاً.

يدعم استدعاء الوظائف، ووضع JSON، والبث عبر SSE.

استجابات التدفق عبر أحداث الإرسال عبر الخادم (SSE)

فعّل التدفق عن طريق تعيين stream القيمة true. استلم الرموز في الوقت الفعلي عبر أحداث الحدث المرسلة من الخادم.

يتم الإبلاغ عن استهلاك الرمز في الشريحة الأخيرة. يعد هذا مثالياً لواجهات الدردشة وخطوط توليف الصوت.

أحداث التدفق موثوقة وتتبع تنسيقات OpenAI القياسية.

وضع JSON واستدعاء الوظائف

فرض إخراج منظم عن طريق تعيين response_format إلى json_object. هذا يضمن تحليلًا متسقًا للتطبيقات اللاحقة.

استخدام tools للاستدعاء الوظيفي. يتعامل النموذج مع تنفيذ الأدوات بسلاسة.

معاملات مثل temperature و top_p التحكم في الإبداع والعشوائية.

المعلمات: درجة الحرارة وtop_p والبذلة

تحكّم في تنوع المخرجات باستخدام temperature (0-2), top_p (0-1)، و seed للتكرار.

استخدام stop التسseqs لتقطيع الاستجابات. presence_penalty و frequency_penalty تقليل التكرار.

تعمل هذه المعلمات تمامًا مثل واجهة برمجة تطبيقات OpenAI SDK.

حدود، أخطاء، ونافذة السياق

حد معدل الطلبات: 300 طلب/دقيقة، 8 طلبات متزامنة. الحد الأقصى لحجم الجسم: 8 ميجابايت.

401: مفتاح غير صالح. 402: بدون رصيد. 429: تم تجاوز حد المعدل.

نافذة السياق هي 100,000 رمز. الحد الأقصى للمخرجات هو 16,000 رمز.

cURL

Copycurl https://api.apigemma.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the gemma model weights config file"}]
  }'

Python

Copyfrom openai import OpenAI

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