واجهة برمجة التطبيقات Gemma: أول طلب في خمس دقائق

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

ابدأ بإنشاء حساب في صفحة الحصول على مفتاح API. لا تحتاج سوى إلى بريد إلكتروني وكلمة مرور؛ ولا يلزم رقم هاتف أو بطاقة ائتمان لتفعيل رصيد التجربة المجاني. بعد التسجيل، يظهر مفتاح API الخاص بك على الفور. انسخ هذا المفتاح واحفظه بأمان. استخدمه في رأس Authorization كرمز Bearer لجميع الطلبات. عنوان URL الأساسي لجميع نقاط النهاية هو https://api.gemma4api.com/v1. يعمل هذا العنوان مع أي عميل متوافق مع OpenAI، مما يتيح لك تغيير المزود بتغيير عنوان URL الأساسي ومفتاح API في إعداداتك فقط.

الطلب الأول

أرسل أول موجّه باستخدام curl للتحقق من الاتصال. استبدل YOUR_API_KEY بمفتاحك الفعلي. مُعرّف النموذج هو uncensored. يؤكد هذا الطلب البسيط للنص إلى النص أن المصادقة صحيحة والنموذج يستجيب. إذا تلقيت استجابة JSON تحتوي على مصفوفة choices، فإن إعدادك مكتمل. يمكنك الآن المضي قدمًا في دمج SDK لعمليات أكثر تعقيدًا.

Copycurl https://api.gemma4api.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

تكامل حزمة SDK لـ Python

قم بتثبيت حزمة Python الرسمية لـ OpenAI. اضبط متغيرات البيئة لعنوان URL الأساسي ومفتاح API أو مررها مباشرةً إلى مُنشئ العميل. استخدم معرف النموذج uncensored للتأكد من أنك تستدعي مثيلنا المحدد. يضمن هذا النهج بقاء الكود الخاص بك متوافقًا مع أنماط OpenAI القياسية مع الاستفادة من نموذجنا بدون رقابة لتوليد المحتوى. تتعامل حزمة SDK مع عمليات إعادة المحاولة وتحليل JSON تلقائيًا.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.gemma4api.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 لـ Node.js

لبيئات JavaScript، قم بتثبيت حزمة OpenAI لـ Node.js. قم بتكوين العميل بعنوان URL الأساسي https://api.gemma4api.com/v1 ومفتاح API الخاص بك. استخدم معرف النموذج uncensored في مكالمات الإكمال. يتيح لك هذا الإعداد الحفاظ على هياكل الكود المتوافقة مع OpenAI مع الاستفادة من سلوك النموذج المحدد المستضاف على خوادمنا. تأكد من معالجة الاستجابات غير المتزامنة بشكل صحيح داخل حلقة أحداث Node.js الخاصة بك.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.gemma4api.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 MB. الأخطاء الشائعة تشمل 401 للمفاتيح غير الصالحة، 402 إذا استُنفد رصيدك المسبق الدفع، و429 إذا تجاوزت الحد الدقيق. يؤدي إعادة إنشاء مفتاح API الخاص بك إلى إلغاء سريان المفتاح القديم لكنه لا يعيد تعيين عداد المعدل. تأكد من أن العميل الخاص بك يتعامل مع أكواد حالة HTTP هذه بشكل مناسب للحفاظ على سلاسة التشغيل.