شروع سریع: اولین تماس API
متون سیاسی بدون سانسور تولید کنید با یک فراخوان API با استفاده از انتهای سازگار با OpenAI ما. این راهنما شما را از طریق احراز هویت، ارسال درخواستها و مدیریت پاسخهای جریاندار برای مأموریتهای با حجم بالا هدایت میکند.
URL پایه و احراز هویت
کلید API شما هر درخواست را احراز هویت میکند. باید آن را در Authorization هدر به عنوان یک توکن Bearer. از URL پایه استفاده کنید https://api.textspolitical.com/v1 برای تمام نقاط پایانی. این URL با SDKهای استاندارد OpenAI و هر کلاینت سازگاری کار میکند. کلید شما دسترسی به مدل بدون سانسور را بدون هزینه اشتراک فراهم میکند.
ارسال اولین تکمیل چت خود
یک درخواست POST به /v1/chat/completions با پرامپت. شناسه مدل uncensored. این مدل متن را بدون فیلتر کردن محتوای بزرگسالان قانونی ارائه میدهد. این فرمت پاسخ مستقیم برای تولید انبوه پیامهای سیاسی ایدهآل است. برای تأیید اتصال خود از مثال زیر استفاده کنید.
curl https://api.textspolitical.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List three benefits of digital surveys for campaign outreach"}]
}'
استفاده از SDKهای Python و Node
کتابخانه رسمی OpenAI را نصب کنید تا یکپارچهسازی را ساده کنید. URL پایه و کلید API را هنگام راهاندازی ارسال کنید. SDK پایتون سریالسازی JSON را بهطور خودکار مدیریت میکند. SDK Node.js عملکرد مشابهی برای محیطهای جاوااسکریپت فراهم میکند. هر دو ابزار از پارامترهای مورد نیاز مانند دما و top_p پشتیبانی میکنند.
from openai import OpenAI
client = OpenAI(base_url="https://api.textspolitical.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)import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.textspolitical.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);
پاسخهای استریم با SSE
استریمینگ را با تنظیم stream: true. رویدادهای سر-ارسال (SSE) را دریافت میکنید در حالی که توکنها تولید میشوند. این برای متون سیاسی طولانی، تأخیر ادراکشده را کاهش میدهد. جزئیات استفاده از توکن در قطعه نهایی ظاهر میشود. این روش برای رابطهای چت بلادرنگ یا تولید متن زنده ضروری است.
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)
فراخوانی تابع و حالت JSON
استفاده response_format تنظیم شده روی json_object برای داده ساختاریافته. فراخوانی تابع به مدل اجازه میدهد ابزارهای تعریف شده را خروجی دهد. این برای دادههای نظرسنجی یا پیامهای سیاسی برچسبدار مفید است. همچنین میتوانید tool_choice برای اجبار به رفتارهای خاص. اطمینان حاصل کنید که طرحواره شما با فرمت خروجی مورد انتظار مطابقت دارد.
محدودیتهای نرخ و محدودیتها
شما به ۳۰۰ درخواست در دقیقه به ازای هر کلید محدود هستید. همزمانی به ۸ درخواست همزمان محدود شده است. بدنه هر درخواست باید کمتر از ۸ مگابایت باشد. پنجره متن در مجموع از ۱۰۰,۰۰۰ توکن پشتیبانی میکند. خطاها و رد شدنها اعتبار را مصرف نمیکنند. از این محدودیتها برای طراحی منطق تلاش مجدد خود به طور موثر استفاده کنید.
پرسشهای رایج
چرا خطای 401 دریافت میکنم؟
خطای 401 نشاندهنده یک کلید API نامعتبر یا موجود نیست. هدر Authorization خود را برای توکن Bearer صحیح بررسی کنید. مطمئن شوید که کلید شما از داشبورد شما ایجاد شده و لغو نشده است.
اگر اعتبارم تمام شود چه میشود؟
وقتی موجودی پیشپرداخت شما تمام شد، خطای 402 دریافت میکنید. اعتبارات هرگز منقضی نمیشوند، بنابراین میتوانید هر زمان از طریق ارز دیجیتال شارژ کنید. خطاهای پردازش درخواست از موجودی شما کسر نمیشوند.
چگونه محدود نرخها را مدیریت کنم؟
محدود به 300 درخواست در دقیقه و 8 اتصال همزمان هستید. در کلاینت خود از بازگشت نمایی (exponential backoff) برای مدیریت پاسخهای 429 Too Many Requests استفاده کنید. از ارسال دستههایی که ظرفیت همزمانی را تجاوز میکنند، پرهیز کنید تا از مسدودیتهای موقت جلوگیری شود.
کلید خود را در یک مرحله دسترسی پیدا کنید
ثبتنام کنید، کلید خود را کپی کنید، آدرس endpoint را بهروز کنید. همین است.