URL پایه و احراز هویت
هر درخواست را با اشاره کلاینت خود به URL پایه صحیح شروع کنید. از کلیدی که هنگام ثبتنام دریافت کردهاید برای ارسال در Authorization header. این هدر حساب کاربری شما را احراز هویت کرده و مصرف اعتبار پیشپرداخت شما را ردیابی میکند.
زیرساخت ما برای توسعهدهندگانی ساخته شده است که دسترسی مستقیم بدون هزینههای مسیریابی واسط میخواهند. شما عملکردی یکپارچه دریافت میکنید زیرا سرورهای خودمان را اجرا میکنیم.
اولین درخواست
ارسان اولین پیام برای بررسی اتصال و پاسخ مدل. از endpoint استاندارد تکمیل چت با پرامپت سیستم و پرسش کاربر خود استفاده کنید. این تأیید میکند که کلید شما کار میکند و پاسخ JSON خام را نشان میدهد.
- تنظیم
modelfield touncensored. - یک پیام کاربر ساده برای تست تأخیر اضافه کنید.
- بررسی کنید
usageobject برای شمارش توکنها.
SDK Python
به سرعت با استفاده از کتابخانه استاندارد Python ادغام کنید. بسته را نصب کنید و کلاینت را با URL پایه و کلید خود راهاندازی کنید. این رویکرد سریالسازی و تلاشها را به صورت خودکار مدیریت میکند.
تاریخچه مکالمه خود را بهصورت لیستی از دیکشنریها تعریف کنید. این موارد را مستقیماً به endpoint چت ارسال کنید. کتابخانه یک شیء پاسخ ساختاریافته بازمیگرداند که میتوانید متن دستیار را از آن استخراج کنید.
Node SDK
منطق سمت سرور را با کلاینت Node.js بسازید. کتابخانه را وارد کنید و کلید API و URL پایه را پیکربندی کنید. این تنظیم برای خدمات بکاند که ورودیهای کاربر را بهطور ناهمزمان پردازش میکنند، خوب کار میکند.
متد completion را با پیامهای خود فراخوانی کنید. پاسخ شامل متن تولید شده و آمار مصرف است. خطاها را بهصورت ایمن مدیریت کنید تا از کرش کردن برنامه خود در بارهای بالا جلوگیری کنید.
پاسخهای استریم
دریافت توکنها بهصورت بلادرنگ برای تجربه کاربری روانتر. Streaming را با تنظیم پرچم مناسب در درخواست خود فعال کنید. سرور قطعات داده را همانطور که تولید میشوند ارسال میکند.
این تکهها را در سمت کلاینت انباشته کنید تا متن به صورت تدریجی نمایش داده شود. این تأخیر ادراکشده را به طور قابل توجهی کاهش میدهد. تکه نهایی را برای استفاده کلی از توکن و دادههای صورتحساب نظارت کنید.
محدودیتها، خطاها و زمینه
به محدودیتهای نرخ احترام بگذارید تا از وقفهها جلوگیری کنید. شما مجاز به 300 درخواست در دقیقه و 8 اتصال همزمان به ازای هر کلید هستید. اگر از این مقدار عبور کنید، خطای 429 دریافت خواهید کرد.
خطای 401 به این معنی است که کلید API شما نامعتبر است. خطای 402 نشاندهنده اعتبار پیشپرداخت ناکافی است. پنجره زمینه (context window) شما در مجموع 100,000 توکن است. پرامپت و پاسخ خود را در این محدودیت نگه دارید تا عملکرد قابل اعتمادی داشته باشید.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'پایتون
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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 = 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)