مفتاح واجهة برمجة التطبيقات (API) cursor دليل البدء السريع

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

ابدأ بإنشاء مفتاح على صفحة "الحصول على مفتاح API". انقر على "متابعة باستخدام Google" أو استخدم البريد الإلكتروني وكلمة المرور. يعرض النظام مفتاحك فوراً. احتفظ به بأمان.

وجّه عميلك إلى HTTPS://api.apikeycursor.com/v1. مرر المفتاح في رأس المصادقة كرمز Bearer. يعمل هذا عنوان URL الأساسي مع حزم SDK الرسمية لـ OpenAI وأي عميل متوافق. تحتاج فقط إلى مفتاح نشط واحد لكل حساب.

• رأس المصادقة: المصادقة: Bearer YOUR_KEY
• URL الأساسي: HTTPS://api.apikeycursor.com/v1

Copycurl https://api.apikeycursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch current server load stats"}]
  }'

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

استدعي POST /v1/chat/completions لتوليد النص. أرسل رسائلك بتنسيق JSON القياسي. معرف النموذج هو uncensored. يعمل على خوادمنا ولا يرفض مواضيع الكبار القانونية.

تتكلف رموز الإدخال 0.15 دولار لكل مليون. تكلف رموز الإخراج 0.50 دولار لكل مليون. الأخطاء والرفض مجانيان. الرصيد لا ينتهي. يمكنك الإيداع بـ USDT على شبكة TRC20 أو USDC على شبكة Base. ابدأ بمبلغ 20 دولاراً. احصل على مكافأة بنسبة 15% عند الإيداع بمبلغ 200 دولار.

Copyfrom openai import OpenAI

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

الاستجابات التدفقية عبر SSE

فعّل التدفق عن طريق تعيين stream إلى true. تتلقى أحداث الإرسال من الخادم. يحتوي كل جزء على نص جزئي. يتضمن الجزء الأخير بيانات استخدام الرموز.

عالج التدفق في الكود الخاص بك. اعالج كل قطعة عند وصولها. هذا يقلل من زمن الوصول المُدرَك للاستجابات الطويلة. يدعم النموذج نافذة سياق بحجم 100,000 رمز. الحد الأقصى للإخراج هو 16,000 رمز لكل طلب.

Copyimport OpenAI from "openai";

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

استدعاء الوظائف ووضع JSON

استخدم معلمة tools لاستدعاء الوظائف. عرّف وظائفك في المخطط. يعيد النموذج بيانات مهيكلة. يمكنك أيضاً فرض إخراج JSON مع تعيين response_format على json_object.

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

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)

المعلمات: درجة الحرارة والبذلة

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

تشمل المعلمات الأخرى top_p، وstop، وpresence_penalty. اضبطها بناءً على حالة الاستخدام الخاصة بك. قم بضبط نمط الاستجابة بدقة. يستجيب نموذج uncensored بشكل جيد للأوامر المباشرة. لا يرفض المواضيع المثيرة للجدل بشكل مفرط.

تحقق من صفحة الأسعار لمعرفة تكلفة الرموز (Tokens). استخدم رصيد التجربة للاختبار.

حدود، أخطاء، والسياق

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

تعيد الأخطاء رموز HTTP القياسية. تعني 401 مفتاحاً غير صالح. تعني 402 عدم وجود رصيد. تعني 429 تجاوز حد معدل الطلبات. تحقق من صفحة الدعم للحصول على استرداد المبالغ. يتم إصلاح الأخطاء مثل الشحن المزدوج هناك. لا يتم استرداد الرصيد بخلاف ذلك.