ar ▾
احصل على مفتاحك

توثيق API لمطوري Cursor

يُظهر هذا الدليل السريع لمستخدمي Cursor IDE كيفية تكوين واجهة برمجة التطبيقات المتوافقة مع OpenAI الخاصة بنا لتوليد النصوص غير المقيدة. استبدل نقطة النهاية القياسية لتجاوز القيود مع الحفاظ على نفس كود العميل الذي تعرفه بالفعل.

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

يعتمد نظام الـ API الخاص بنا على مصادقة رمز حامل (Bearer token) قياسية. اضبط عنوان URL الأساسي الخاص بك على HTTPS://api.cursoraiapikey.com/v1 ومرر مفتاحك في رأس Authorization. تعمل نقطة النهاية هذه مع أي إطار عمل متوافق مع OpenAI. تحصل على مفتاح على الفور بعد التسجيل باستخدام Google أو البريد الإلكتروني. لا يلزم رقم هاتف. الرصيد لا ينتهي. الأخطاء مجانية. الرفضات مجانية. ادفع فقط مقابل الرموز الحقيقية. Authorization: Bearer YOUR_API_KEY هو كل ما تحتاجه. ابدأ بإرسال الطلبات فوراً. النظام بسيط. الشفافية مهمة.

الطلب الأول

أرسل طلب POST إلى /v1/chat/completions لتوليد النص. استخدم النموذج "uncensored" للحصول على إجابات غير مقيدة. ضمّن رسالة النظام لتوجيه السلوك. تقبل الواجهة الهيكلة القياسية لـ OpenAI. إليك مثال أساسي باستخدام curl. استبدل YOUR_API_KEY ببيانات الاعتماد الخاصة بك. أرسل رسالتك واحصل على مخرجات نصية. هذا هو التفاعل الأساسي. اجعله بسيطًا.

curl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List three key features of the new API update"}]
  }'

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

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

from openai import OpenAI

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

قم بتهيئة عميل OpenAI في Node.js. قم بتجاوز basePath إلى عنوان URL الخاص بنا. اضبط apiKey على بيانات الاعتماد الخاصة بك. استدعِ chat.completions.create(). مرر النموذج كـ "uncensored". انتظر النتيجة. تعامل مع الأخطاء بسلاسة. بيئة Node قوية. تحصل على استجابات فورية. الكود نظيف. التبعيات قياسية. لا حاجة لمكتبات إضافية. فقط قم بتكوين العميل. شغل النص البرمجي. احصل على النص. البساطة هي الفوز.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.cursoraiapikey.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. استلم الرموز عبر أحداث مرسلة من الخادم. استخدم استدعاء الوظائف للتكامل مع الأدوات. عرّف الأدوات في طلبك. يُعيد النموذج الحجج. حللها بأمان. يوجد دعم لنمط JSON. اضبط response_format على json_object. يضمن هذا مخرجات صالحة. اجمع بين التدفق والأدوات لتطبيقات ديناميكية. تحدث التحديثات في الوقت الفتح يحسن تجربة المستخدم. المطورون يحبون زمن الاستجابة المنخفض. تحكم في التدفق. تكيف مع الاحتياجات. المرونة أمر ضروري.

stream = 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 رمز. الحد الأقصى للمخرجات هو 16,000 رمز. حد الطلبات في الدقيقة هو 300. الطلبات المتزامنة لكل مفتاح هي 8. الحد الأقصى لحجم الجسم هو 8 ميجابايت. الخطأ 401 يعني مفتاحًا غير صالح. الخطأ 402 يعني عدم وجود رصيد. الخطأ 429 يعني حد المعدل. الرصيد مسبق الدفع. الأخطاء مجانية. الرفض مجاني. لا رسوم شهرية. استخدم العملة المشفرة للشحن. USDT أو USDC. ابدأ بـ $20. احصل على مكافآت. استمر في البرمجة.

الأسئلة الشائعة

كيف أبدأ مع مفتاح Cursor AI API؟

سجّل باستخدام Google أو البريد الإلكتروني على صفحة Get API key. يظهر المفتاح على الفور. لا يلزم رقم هاتف. أضف $20 بالعملات المشفرة لبدء استخدام نموذج اللغة الكبير غير الخاضع للرقابة. رصيد تجريب بقيمة $0.50 متاح للحسابات الجديدة. يستمر لمدة 7 أيام.

ما هو نافذة السياق وحد الإخراج؟

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

لماذا أحصل على خطأ 402؟

يشير خطأ 402 إلى استنفاد رصيدك المدفوع مسبقاً. لا تفرض واجهة برمجة التطبيقات رسوماً على الأخطاء أو الرفضات. تدفع فقط مقابل الرموز الحقيقية المستخدمة. قم بالإضافة باستخدام USDT (TRC20) أو USDC (Base). الحد الأدنى للإضافة هو $20. تنطبق المكافآت على المستويات الأعلى. أضف الأموال لاستئناف الخدمة فوراً.

احصل على مفتاح API الخاص بك

سجّل، انسخ بيانات الاعتماد، وحدّث عنوان URL الأساسي. هذا كل ما تحتاج إلى القيام به.