مستندات API برای توسعه‌دهندگان Cursor

احراز هویت و URL پایه

API ما از احراز هویت استاندارد Bearer token استفاده می‌کند. URL پایه خود را به HTTPS://api.cursoraiapikey.com/v1 تنظیم کنید و کلید خود را در هدر Authorization ارسال کنید. این اندپوینت با هر SDK سازگار با OpenAI کار می‌کند. بلافاصله پس از ثبت‌نام با Google یا ایمیل، یک کلید دریافت می‌کنید. شماره تلفن لازم نیست. اعتبار منقضی نمی‌شود. خطاها رایگان هستند. رد شدن‌ها رایگان هستند. فقط بابت توکن‌های واقعی پرداخت کنید. Authorization: Bearer YOUR_API_KEY همان چیزی است که نیاز دارید. بلافاصله شروع به ارسال درخواست کنید. سیستم ساده است. شفافیت مهم است.

اولین درخواست

درخواست POST را به /v1/chat/completions ارسال کنید تا متن تولید شود. از مدل "uncensored" برای پاسخ‌های بدون محدودیت استفاده کنید. دستور سیستم خود را برای هدایت رفتار مدل وارد کنید. API ساختارهای JSON استاندارد OpenAI را می‌پذیرد. در اینجا یک مثال پایه با curl آورده شده است. YOUR_API_KEY را با اعتبار خود جایگزین کنید. پیام خود را ارسال کنید و خروجی متنی دریافت کنید. این تعامل اصلی است. آن را ساده نگه دارید.

Copycurl 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"}]
  }'

یکپارچه‌سازی SDK Python

از بسته رسمی پایتون OpenAI استفاده کنید. URL پایه و کلید API را تنظیم کنید. پیام‌ها را به صورت لیستی از دیکشنری‌ها پاس دهید. مدل "uncensored" را درخواست دهید. SDK تلاش‌های مجدد را به صورت خودکار مدیریت می‌کند. استریم پشتیبانی می‌شود. فراخوانی تابع نیز کار می‌کند. temperature و top_p را برای کنترل پیکربندی کنید. این رویکرد تغییرات کد را به حداقل می‌رساند. منطق موجود شما سالم می‌ماند. فقط به URL ما اشاره کنید. کارایی کلیدی است. توسعه‌دهندگان ابزارهای آشنا را ترجیح می‌دهند.

Copyfrom 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" وارد کنید. نتیجه را await کنید. خطاها را به‌طور شایسته مدیریت کنید. اکوسیستم Node قوی است. شما پاسخ‌های بلادرنگ دریافت می‌کنید. کد تمیز است. وابستگی‌ها استاندارد هستند. به کتابخانه اضافی نیاز نیست. فقط کلاینت را پیکربندی کنید. اسکریپت خود را اجرا کنید. متن خود را دریافت کنید. سادگی برنده است.

Copyimport 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، پخش زنده (streaming) را فعال کنید. توکن‌ها را از طریق رویدادهای ارسالی سرور دریافت کنید. برای یکپارچه‌سازی ابزارها از فراخوانی تابع استفاده کنید. ابزارها را در درخواست خود تعریف کنید. مدل آرگومان‌ها را برمی‌گرداند. آن‌ها را به صورت ایمن تجزیه کنید. پشتیبانی از حالت JSON وجود دارد. response_format را روی json_object تنظیم کنید. این خروجی معتبر را تضمین می‌کند. پخش زنده را با ابزارها برای برنامه‌های پویا ترکیب کنید. به‌روزرسانی‌های بلادرنگ UX را بهبود می‌بخشند. توسعه‌دهندگان تأخیر کم را دوست دارند. جریان را کنترل کنید. با نیازها سازگار شوید. انعطاف‌پذیری ضروری است.

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)

محدودیت‌ها، خطاها و زمینه

پنجره زمینه ۱۰۰,۰۰۰ توکن است. حداکثر خروجی ۱۶,۰۰۰ توکن است. محدودیت درخواست در دقیقه ۳۰۰ است. درخواست‌های همزمان در هر کلید ۸ است. حداکثر اندازه بدنه ۸ مگابایت است. خطای ۴۰۱ به معنای کلید نامعتبر است. خطای ۴۰۲ به معنای عدم اعتبار است. خطای ۴۲۹ به معنای محدودیت نرخ است. اعتبار پیش‌پرداخت است. خطاها رایگان هستند. رد شدن‌ها رایگان هستند. هزینه ماهانه ندارند. از ارز دیجیتال برای شارژ استفاده کنید. USDT یا USDC. با ۲۰ دلار شروع کنید. پاداش بگیرید. کدنویسی را ادامه دهید.