دليل البدء السريع لـ API للبرمجة

إعداد المصادقة

ابدأ بإنشاء حساب والحصول على مفتاح API. تحتاج فقط إلى بريد إلكتروني وكلمة مرور؛ لا حاجة لبطاقة ائتمان للبدء. عند التسجيل، تتلقى مفتاح API واحدًا على الفور. هذا المفتاح يصادق على جميع الطلبات إلى نقطة النهاية الأساسية: https://api.codingllmapi.com/v1.

احتفظ بمفتاحك آمنًا. يمكنك تجديده في أي وقت من لوحة التحكم، مما يلغي المفتاح السابق فورًا. معرف النموذج المرسل في طلباتك هو uncensored. هذا نموذج مفتوح الأوزان يعمل على خوادمنا الخاصة، وليس وسيطًا لـ GPT أو Claude أو Gemini.

الطلب الأول

أرسل طلب إكمال محادثة قياسي باستخدام التنسيق المتوافق مع OpenAI. تقبل API الرسائل مع دور (مستخدم/مساعد/نظام) ومحتوى. يعيد إخراج نص محسّن لتوليد الكود دون تصفية المواضيع القانونية للبالغين أو المثيرة للجدل (باستثناء القاصرين).

• نقطة النهاية الأساسية: https://api.codingllmapi.com/v1
• نقطة النهاية: POST /v1/chat/completions
• النموذج: uncensored

Copycurl https://api.codingllmapi.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

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

تأكد من استخدام إصدار حديث من حزمة openai. سيتعامل العميل مع تسلسل JSON وبيانات HTTP بشكل صحيح لنقطة النهاية الخاصة بنا.

Copyfrom openai import OpenAI

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

استخدم حزمة openai الرسمية لـ Node.js، وليس SDKs الخاصة بـ Anthropic أو Google. قم بتكوين نقطة النهاية الأساسية لتشير إلى خدمتنا. يضمن هذا التوافق مع هيكل الطلب المتوافق مع OpenAI الذي نقدمه.

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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.codingllmapi.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 (Server-Sent Events). يحتوي كل جزء على مخرجات رموز جزئية، مما يتيح لوكيلك عرض الكود أثناء إنشائه. يقلل هذا من زمن الاستجابة المُدرَك لكتل الكود الطويلة.

عالج أحداث التدفق لتراكم الاستجابة النهائية. يستمر النموذج في التوليد حتى يصل إلى حد نافذة السياق أو معلمة max_tokens.

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)

الحدود والأخطاء

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

نافذة السياق هي 100,000 رمز إجماليًا (الموجّه + الإكمال). إذا تجاوز الموجّه الخاص بك والكود المولد هذا، يتوقف النموذج. خطط لرموز الإدخال بعناية لترك مساحة للإخراج.