کلید API راهنمای شروع سریع cursor

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

ابتدا با رفتن به صفحه دریافت کلید API، یک کلید تولید کنید. روی «ادامه با Google» کلیک کنید یا از ایمیل و رمز عبور استفاده کنید. سیستم کلید شما را بلافاهه نمایش می‌دهد. آن را امن نگه دارید.

کلاینت خود را به HTTPS://api.apikeycursor.com/v1 پوینت کنید. کلید را به عنوان توکن Bearer در هدر Authorization ارسال کنید. این URL پایه با SDKهای رسمی OpenAI و هر کلاینت سازگار دیگری کار می‌کند. شما به ازای هر حساب کاربری تنها به یک کلید فعال نیاز دارید.

• هدر Auth: Authorization: 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 است. این مدل روی سرورهای ما اجرا می‌شود و موضوعات بزرگسالان قانونی را رد نمی‌کند.

توکن‌های ورودی ۰.۱۵ دلار به ازای هر ۱ میلیون، و توکن‌های خروجی ۰.۵۰ دلار به ازای هر ۱ میلیون هزینه دارند. خطاها و رد شدن درخواست‌ها رایگان هستند. اعتبار هرگز منقضی نمی‌شود. می‌توانید با USDT روی شبکه TRC20 یا USDC روی شبکه Base شارژ کنید. شروع با ۲۰ دلار. با شارژ ۲۰۰ دلار، ۱۵٪ اعتبار هدیه دریافت کنید.

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، پخش زنده را فعال کنید. شما رویدادهای سربرگ‌فرستاده‌شده دریافت می‌کنید. هر قطعه حاوی متن ناقص است. قطعه نهایی شامل داده‌های مصرف توکن است.

استریم را در کد خود مدیریت کنید. هر قطعه را هنگام دریافت پردازش کنید. این کار تأخیر ادراک‌شده را برای پاسخ‌های طولانی کاهش می‌دهد. مدل از پنجره زمینه ۱۰۰,۰۰۰ توکنی پشتیبانی می‌کند. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است.

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 اجبار کنید.

این برای یکپارچه‌سازی کلید API کرسر کار می‌کند. 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

خلاقیت را با دما کنترل کنید. مقادیر بالاتر خروجیات را تصادفی‌تر می‌کنند. مقادیر پایین‌تر آن‌ها را قطعی می‌کنند. از seed برای نتایج قابل بازتولید استفاده کنید. این به اشکال‌زدایی مهندسی پرامپت کمک می‌کند.

پارامترهای دیگر شامل top_p، stop و presence_penalty هستند. آن‌ها را بر اساس مورد استفاده خود تنظیم کنید. سبک پاسخ را دقیق‌تر کنید. مدل uncensored به پرامپت‌های مستقیم خوب پاسخ می‌دهد. موضوعات جنجالی را بیش از حد رد نمی‌کند.

صفحه قیمت‌گذاری را برای هزینه توکن‌ها بررسی کنید. از اعتبار آزمایشی برای تست استفاده کنید.

Limits, errors, and context

شما ۳۰۰ درخواست در دقیقه دریافت می‌کنید. می‌توانید ۸ درخواست را همزمان اجرا کنید. محدودیت بدنه درخواست ۸ مگابایت است. پنجره زمینه در مجموع ۱۰۰,۰۰۰ توکن است. پرامپت و تکمیل این فضا را به اشتراک می‌گذارند.

خطاها کدهای HTTP استاندارد را برمی‌گردانند. 401 به معنای کلید نامعتبر است. 402 به معنای عدم موجودی است. 429 به معنای تجاوز از محدودیت نرخ است. برای استرداد وجه به صفحه پشتیبانی مراجعه کنید. خطاهایی مانند شارژ مضاعف در آنجا رفع می‌شوند. اعتبار به طور دیگری استرداد نمی‌شود.