بداية سريعة لـ API: اربط عميلك بنموذجنا غير الخاضع للرقابة

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

يذهب كل طلب إلى https://doesgrokhaveanapi.com/v1 ويحمل مفتاحك في Authorization الرأس كرمز حامل. انسخ المفتاح من صفحة الحصول على مفتاح واجهة برمجة التطبيقات؛ يظهر مرة واحدة عند التسجيل، ويمكنك استبداله في أي وقت.

مختصر ومباشر: عنوان URL الأساسي والمفتاح هما القيمتان الوحيدتان اللتان تتغيران عند نقل عميل موجود.

Copycurl https://api.doesgrokhaveanapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current API endpoint for the model?"}]
  }'

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

إرسال POST /v1/chat/completions مع قائمة من الرسائل. يحتوي الرد على نفس شكل استجابة إكمال الدردشة من OpenAI، لذا تستمر المفسرات الموجودة في العمل.

• استخدم الدور user لأداتك و system للحصول على التعليمات.
• اقرأ الإجابة من choices[0].message.content.
• تعود أعداد الرموز في usage، وهذا ما يُخصم من رصيدك.

Copyfrom openai import OpenAI

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

النموذج المدعوم: 'uncensored'

عيّن حقل النموذج إلى uncensored. هذا هو معرف النموذج الوحيد في الخدمة، لذا لا يوجد خيار للاختيار. GET /v1/models يعيدها، وهي طريقة سريعة للتأكد من أن المفتاح يعمل.

النموذج هو نموذج مفتوح الأوزان يعمل على خوادمنا الخاصة. ولا يرفض الطلبات القانونية للبالغين، أو الخيالية، أو المثيرة للجدل. الحد الصارم الوحيد هو المحتوى الجنسي الذي يتضمن قاصرين.

الدفق واستدعاء الوظائف

إضافة stream: true لتلقي الرموز كحدث مرسل من الخادم. يحمل القطعة الأخيرة أرقام الاستخدام، لذا يمكنك تسجيل التكلفة لكل طلب دون حاجة إلى استدعاء ثانٍ.

يعمل استدعاء الوظائف من خلال المعيار tools و tool_choice الحقول. عرّف كل دالة باستخدام مخطط JSON واقرأ tool_calls مصفوفة الرد.

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)

المعاملات: درجة الحرارة، Top P، و Stop

معلمات أخذ العينات المدعومة هي temperature, top_p, stop, seed, presence_penalty و frequency_penalty. استخدم درجة حرارة منخفضة للكود والاستخراج، ودرجة أعلى للخيال.

إذا لم تقم بتعيين max_tokens، الحد الافتراضي للإخراج هو 2,048 رمزًا. الحد الأقصى الصارم لكل طلب هو 16,000 رمز.

وضع JSON وتنسيقات الاستجابة

تعيين response_format إلى { 'type': 'json_object' } عندما تحتاج إلى مخرجات قابلة للقراءة آليًا. اطلب JSON في الأمر أيضًا، لأن النموذج يتبع التعليمات والتنسيق معًا.

1. صف الحقول التي تحتاجها في رسالة النظام.
2. اجعل المثال قصيراً، مفتاحين أو ثلاثة.
3. تحقق من النتيجة في كودك قبل تخزينها.

حدود معدل الطلبات ومعالجة الأخطاء

يمكن لكل مفتاح إرسال 300 طلب في الدقيقة و8 طلبات في نفس الوقت. يتم رفض الطلبات التي تحتوي على جسم أكبر من 8 ميجابايت. يعني رمز 401 أن المفتاح غير صحيح، ورمز 402 يعني نفاد الرصيد، ورمز 429 يعني أنك تجاوزت حد المعدل: انتظر وأعد المحاولة مع استخدام استراتيجية التراجع الخلفي.

لا يتم احتساب تكاليف الأخطاء والرفض. ضع في اعتبارك نافذة السياق البالغة 100,000 رمز للخيوط الطويلة: يتم حساب عدد الرموز في المدخلات والمخرجات معًا.

Node.js

Copyimport OpenAI from "openai";

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