راهنمای شروع سریع API

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

از URL پایه خاص خود و یک کلید API معتبر برای هر درخواست استفاده کنید.

آدرس پایه https://api.pricingapideepseek.com/v1. پیکربندی SDK خود را به‌روزرسانی کنید تا به جای نقطه پایانی پیش‌فرض OpenAI به اینجا اشاره کند. احراز هویت با ارسال کلید API خود در Authorization header. برای هر حساب یک کلید دریافت می‌کنید. اگر کلید جدیدی نیاز دارید، کلید قدیمی بلافاصله از کار می‌افتد. با اعتبار آزمایشی $0.50 شروع کنید تا اتصال را قبل از خرید ارز دیجیتال تأیید کنید.

اولین تکمیل چت خود را ارسال کنید

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید تا پاسخ متنی دریافت کنید.

این یک جایگزین مستقیم برای کلاینت‌های استاندارد OpenAI است. شناسه مدل را به عنوان تعریف می‌کنید uncensored. API متن را بر اساس درخواست شما برمی‌گرداند. خطاهایی مانند اعتبار ناکافی یا کلیدهای نامعتبر، کدهای وضعیت HTTP استاندارد را برمی‌گردانند. برای تولید متن پایه نیازی به پیکربندی اضافی نیست.

• نقطه پایانی: POST /v1/chat/completions
• شناسه مدل: uncensored
• ورودی: فقط پرامپت‌های متنی

اگر خطای 402 دریافت کردید، موجودی خود را بررسی کنید. با USDT یا USDC شارژ کنید تا بدون وقفه به استفاده از سرویس ادامه دهید.

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

کتابخانه OpenAI Python را پیکربندی کنید تا از URL پایه و کلید شما استفاده کند.

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

• تنظیم base_url به نقطه پایان API ما.
• تنظیم api_key به کلید منحصر‌به‌فرد خود.
• فراخوانی chat.completions.create با مدل uncensored.

خطاها به عنوان استثناهای استاندارد ایجاد می‌شوند. برای جزئیات مربوط به محدودیت نرخ یا مشکلات مالی، پیام خطا را بررسی کنید.

پیکربندی Node SDK

کلاینت Node.js OpenAI را با میزبان سفارشی و اعتبارنامه‌های ما مقداردهی اولیه کنید.

این روش برای برنامه‌های سمت سرور یا محیط‌های Node.js به خوبی کار می‌کند. شما URL پایه و کلید API را هنگام راه‌اندازی ارسال می‌کنید. بقیه توابع SDK دقیقاً مانند نسخه استاندارد عمل می‌کند. می‌توانید پیام ارسال کنید و پاسخ‌های متنی دریافت کنید بدون اینکه منطق خود را تغییر دهید.

• پکیج OpenAI را ایمپورت کنید.
• یک نمونه کلاینت با URL پایه سفارشی ایجاد کنید.
• از استاندارد chat.completions.create روش.

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

پاسخ‌های استریم با SSE

پخش زنده را فعال کنید تا توکن‌ها به محض تولید دریافت شوند.

تنظیم stream: true در درخواست شما. API برای هر توکن رویدادهای ارسالی سرور (SSE) ارسال می‌کند. این امر تأخیر ادراک‌شده را برای کاربران نهایی کاهش می‌دهد. شما قطعات را همان‌طور که دریافت می‌شوند پردازش می‌کنید. قطعه نهایی شامل کل مصرف توکن برای صورت‌حساب است. این برای رابط‌های کاربری چت و برنامه‌های بلادرنگ ایده‌آل است.

• تنظیم stream به true.
• رویدادهای SSE را در کد خود مدیریت کنید.
• توکن‌ها را تدریجی نمایش دهید.

استریم‌دهی قیمت‌گذاری را تغییر نمی‌دهد. شما بابت کل توکن‌های استفاده شده پرداخت می‌کنید. خطاها در حین استریم در قطعه نهایی ارسال می‌شوند. به دنبال فیلدهای خطا در آن رویداد آخر بگردید.

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

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

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

cURL

Copycurl https://api.pricingapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the per million token costs for input and output."}]
  }'

پایتون

Copyfrom openai import OpenAI

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