راهنمای یکپارچه‌سازی برای توسعه‌دهندگان

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

ابتدا کلاینت خود را به URL پایه ما اشاره دهید و کلید API خود را در هدر authorization ارائه دهید. این کار با هر SDK سازگار با OpenAI کار می‌کند زیرا ما دقیقاً از پروتکل استاندارد پیروی می‌کنیم. کلید خود را به‌طور فوری از طریق گوگل یا ایمیل در صفحه دریافت کلید API ایجاد کنید؛ نیازی به شماره تلفن نیست. کلید خود را امن نگه دارید و از یک کلید فعال برای هر حساب استفاده کنید، زیرا ایجاد کلید جدید، کلید قبلی را جایگزین می‌کند.

احراز هویت ساده است. کلید خود را در ارسال کنید Authorization هدر برای هر درخواست. سیستم ما کلید را قبل از پردازش توکن‌ها اعتبارسنجی می‌کند، تضمین می‌کند که فقط حساب‌های مجاز اعتبار را مصرف کنند. خطاهایی مانند کلید ناموجود بلافاصله وضعیت 401 را برمی‌گردانند.

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

یک درخواست تکمیل چت استاندارد ارسال کنید تا اتصال و کیفیت پاسخ را آزمایش کنید. این تماس ساده کلید شما را تأیید کرده و اعتبار حساب شما را به درستی شارژ می‌کند. شناسه مدل uncensored, که ورودی و خروجی متن را بدون رد محتوای بزرگسالان قانونی مدیریت می‌کند، مشخص کنید. جایگزین را با کلید و پرامپت سیستم واقعی خود جایگزین کنید.

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

این دستور curl ساختار حداقل مورد نیاز را نشان می‌دهد. می‌توانید messages آرایه برای افزودن زمینه یا دستورالعمل‌ها. پاسخ، متن تولید شده را در content فیلد. آمار مصرف را در هدرهای پاسخ بررسی کنید تا مصرف توکن خود را پایش کنید.

SDK Python

از کتابخانه رسمی پایتون OpenAI برای یکپارچه‌سازی API ما در اسکریپت‌ها یا برنامه‌های خود استفاده کنید. URL base_url و api_key ویژگی‌ها قبل از ارسال درخواست. این رویکرد سازگاری با کدهای موجود که از مدل‌های OpenAI استفاده می‌کنند را تضمین می‌کند. شما می‌توانید با تغییر تنها دو خط پیکربندی، بین ارائه‌دهندگان جابجا شوید.

Copyfrom openai import OpenAI

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

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

Node SDK

API ما را در برنامه‌های Node.js ادغام کنید با استفاده از openai پکیج npm. کلاینت را با URL پایه ما و کلید API خود دقیقاً مانند زمانی که برای OpenAI استفاده می‌کنید، پیکربندی کنید. این به شما اجازه می‌دهد تا از همان ساختار کد برای تست و تولید استفاده کنید. SDK از عملیات ناهمزمان برای درخواست‌های غیرمسدودکننده پشتیبانی می‌کند.

Copyimport OpenAI from "openai";

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

این مثال Node.js ارسال یک درخواست تکمیل چت را نشان می‌دهد. The await کلمه کلیدی تضمین می‌کند که پاسخ کاملاً دریافت شود قبل از ادامه. می‌توانید خطاها را با استفاده از بلوک‌های try-catch مدیریت کنید تا مشکلات شبکه یا محدودیت‌های API را به‌طور شایسته مدیریت کنید. شی پاسخ شامل متن تولید شده و جزئیات مصرف توکن است.

جریان‌سازی

جریان‌سازی را فعال کنید تا پاسخ‌های توکن به توکن دریافت کنید و تجربه کاربری در رابط‌های چت بهبود یابد. مقدار stream پارامتر را در درخواست خود به true تنظیم کنید. API قطعات متن را همان‌طور که تولید می‌شوند برمی‌گرداند و به شما امکان می‌دهد خروجی را در زمان واقعی نمایش دهید. این موضوع تأخیر ادراک‌شده را برای کاربران نهایی به‌طور قابل‌توجهی کاهش می‌دهد.

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)

کد استریم بالا هر قطعه را هنگام دریافت پردازش میکند. می‌توانید محتوا را بلافاصله به یک عنصر رابط کاربری اضافه کنید. قطعه نهایی شامل آمار مصرف کل توکن‌هاست. این ویژگی توسط تمام کلاینت‌های سازگار با OpenAI که پاسخ‌های SSE را به‌درستی مدیریت می‌کنند، پشتیبانی می‌شود.

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

API ما محدودیت‌های سخت‌گیرانه برای اطمینان از استفاده منصفانه و پایداری سیستم اعمال می‌کند. شما مجاز به ۳۰۰ درخواست در دقیقه و ۸ درخواست همزمان به ازای هر کلید هستید. هر بدنه درخواست نباید از ۸ مگابایت تجاوز کند. اگر از این محدودیت‌ها تجاوز کنید، API کد وضعیت 429 را برمی‌گرداند. چند ثانیه صبر کنید و درخواست خود را مجدداً ارسال کنید. خطاهایی مانند کلیدهای نامعتبر 401 را برمی‌گردانند و اعتبار ناکافی 402 را برمی‌گردانند.

پنجره زمینه (context window) تا ۱۰۰,۰۰۰ توکن برای ورودی و خروجی ترکیبی پشتیبانی می‌کند. حداکثر خروجی در هر درخواست ۱۶,۰۰۰ توکن است، یا ۲,۰۴۸ اگر مشخص نکنید max_tokens. این پنجره بزرگ به شما امکان می‌دهد اسناد طولانی را پردازش کنید یا تاریخچه مکالمات گسترده را بدون قطعیت حفظ کنید. خطاها و رد شدن‌ها اعتبار مصرف نمی‌کنند، بنابراین فقط برای استفاده واقعی پرداخت می‌کنید.