البدء السريع: توصيل العميل الخاص بك

المتطلبات الأساسية وتثبيت حزمة التطوير (SDK)

ثبّت الحزمة الرسمية (SDK) الخاصة بلغتك للتعامل مع المصادقة وتسلسل الطلبات تلقائيًا. تحتاج إلى مفتاح API صالح وعنوان URL الأساسي مُعدّلًا في بيئة العميل. تقبل خدمتنا المعايير القياسية مثل temperature و top_p دون الحاجة إلى رؤوس مخصصة.

تأكد من أن متغير البيئة الخاص بك يحتوي على الرمز بشكل آمن قبل تشغيل أي نصوص برمجية. يجب أن تكون إصدارات SDK حديثة لدعم ميزات التدفق ووضع JSON بشكل صحيح. لا يلزم تثبيت برامج تشغيل إضافية لتوليد النصوص فقط.

تكوين عنوان URL الأساسي والمفتاح

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

استبدل نقطة نهاية OpenAI الافتراضية بمضيفنا لتجنب الالتباس مع المزودين الآخرين. احتفظ بمفتاحك سراً ولا تعرضه في المستودعات العامة. يبقى التكوين ثابتاً حتى تقوم بتدوير مفتاحك.

إرسال طلبك الأول

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

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

تحقق من الاستجابة للحصول على تفاصيل المحتوى واستخدام الرموز. إذا تلقيت خطأ 401، تحقق من تنسيق مفتاحك. يشير خطأ 402 إلى أنك بحاجة إلى شحن رصيدك.

معالجة استجابات التدفق

تمكين التدفق لتلقي الرموز في الوقت الفعلي كما يتم إنشاؤها. يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين الذين ينتظرون مخرجات طويلة. تحتوي الحزمة الأخيرة على إجمالي عدد الرموز النهائية لدقة الفوترة.

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)

تعامل مع الاستجابات الجزئية بسلاسة في كود العميل الخاص بك. قم بتخزين المحتوى مؤقتًا حتى ينتهي البث أو يحدث خطأ. يعمل البث مع جميع المعلمات القياسية بما في ذلك تعديلات درجة الحرارة.

تكامل واجهة برمجة تطبيقات Python

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapiminimax.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 SDK والحدود

قم بالتكامل مع تطبيقات Node.js باستخدام حزمة JavaScript الرسمية. حدد عنوان URL الأساسي لضمان وصول الطلبات إلى نقطة النهاية غير المقيدة. راقب استخدامك للبقاء ضمن حدود معدل الطلبات.

Copyimport OpenAI from "openai";

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

يمكنك إرسال 300 طلبًا في الدقيقة مع تزامن يبلغ 8 طلبات. يجب أن يبقى حجم جسم الطلب أقل من 8 ميجابايت. يدعم نافذة السياق 100,000 رمز إجماليًا. لا تستهلك الأخطاء والرفضات الرصيد، لكن المخرجات الناجحة تستهلكه. احفظ مفتاحك بأمان وقم بتدويره إذا لزم الأمر.

فهم استخدام الرموز

تعتمد الفوترة على الرموز المميزة المستخدمة فعلياً في المطالبة والاكتمال. تكلف الرموز المميزة للإدخال 0.15 دولار لكل مليون، بينما تكلف الرموز المميزة للإخراج 0.50 دولار لكل مليون. يغطي الرصيد المدفوع مسبقاً جميع الاستخدامات بدون رسوم شهرية.

الأخطاء والرفض مجانيان، لذا تدفع فقط مقابل الاستجابات الناجحة. يحتوي الجزء الأخير في التدفق على عدد الرموز. راقب لوحة التحكم الخاصة بك لتتبع الإنفاق وتجنب نفاد الرصيد. قم بالإضافة باستخدام USDT أو USDC للوصول الفوري.