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

پیش‌نیازها: کلید API شما

کلید خود را بلافاصله پس از ورود ایجاد کنید. به صفحه دریافت کلید API مراجعه کنید و با Google یا رمز عبور ایمیل احراز هویت کنید. رابط کاربری کلید منحصر‌به‌فرد شما را به‌طور فوری نمایش می‌دهد و نیازی به شماره تلفن نیست. این رشته را امن نگه دارید زیرا تمام درخواست‌ها را به URL پایه احراز هویت می‌کند. شما به‌طور خودکار $0.50 اعتبار آزمایشی دریافت می‌کنید که اگر استفاده نشود، پس از هفت روز منقضی می‌شود.

پیکربندی Cursor برای سازگاری با OpenAI

مشتری خود را به نقطه پایانی اختصاصی ما هدایت کنید تا مسیریابی صحیح تضمین شود. URL پایه را روی HTTPS://api.keyapicursor.com/v1 تنظیم کنید و کلید خود را در هدر احراز هویت تزریق کنید. این پیکربندی با هر SDK سازگار با OpenAI بدون تغییر نام مدل کار می‌کند. باید شناسه مدل را به عنوان uncensored مشخص کنید تا خروجی وزن‌باز را دریافت کنید.

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

یک تکمیل ساده را اجرا کنید تا اتصال و تأخیر را بررسی کنید. از دستور curl زیر برای ارسال یک پرامپت پایه به پایانه تکمیل چت استفاده کنید. پاسخ یک شیء JSON شامل متن تولید شده را برمی‌گرداند. فیلد usage را بررسی کنید تا تأیید کنید که مصرف توکن با انتظارات شما مطابقت دارد.

مدیریت پاسخ‌های جریان‌سازی

توکن‌ها را برای کاهش تأخیر ادراک‌شده در برنامه‌های تعاملی پخش کنید. سرور رویدادهای ارسالی سرور را حاوی دلتاهای جزئی می‌فرستد تا زمانی که قطعه نهایی شامل داده‌های مصرف کلی باشد. این رویدادها را تجزیه کنید تا رابط کاربری خود را به صورت بلادرنگ به‌روزرسانی کنید. این روش به طور یکسان در کلاینت‌های Python و Node کار می‌کند.

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

کتابخانه‌های موجود را با تنظیم فقط پارامترهای URL پایه و کلید استفاده مجدد کنید. قطعه پایتون ادغام مستقیم با کتابخانه رسمی مشتری را نشان می‌دهد. مثال Node الگوی مشابهی برای محیط‌های جاوااسکریپت دنبال می‌کند. هر دو روش به صورت پیش‌فرض از حالت JSON و فراخوانی تابع پشتیبانی می‌کنند.

درک محدودیت‌های نرخ و توکن‌ها

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

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

پایتون

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

جریان‌سازی

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)