Claude api key production checklist

چرا از کلید API کلاد تغییر دهید؟

API ما یک جایگزین مستقیم و بدون سانسور برای توسعه‌دهندگانی ارائه می‌دهد که به تولید محتوای بدون محدودیت بدون مسیریابی پیچیده مدل نیاز دارند. در حالی که کلید API Claude نیازهای خاص سازمانی را برآورده می‌کند، رویکرد تک‌مدلی ما یکپارچه‌سازی را ساده‌تر کرده و سربار عملیاتی را کاهش می‌دهد. شما کیفیت خروجی ثابتی برای موضوعات بزرگسالان، داستانی یا بحث‌برانگیز بدون ردی‌های غیرمنتظره دریافت می‌کنید.

آدرس پایه HTTPS://api.gemmaapikey.com/v1 با هر کلاینت سازگار با OpenAI کار می‌کند. این بدان معناست که شما فقط base_url و کلید API را در کد موجود خود تغییر می‌دهید. نیازی به SDKهای جدید یا جریان‌های احراز هویت پیچیده نیست.

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

درک هزینه‌های توکن

قیمت‌گذاری ما ساده است: ۰.۱۵ دلار برای هر ۱ میلیون توکن ورودی و ۰.۵۰ دلار برای هر ۱ میلیون توکن خروجی. خطاها و رد شدن درخواست‌ها هزینه‌ای ندارند، بنابراین شما فقط بابت مصرف واقعی توکن پرداخت می‌کنید. این مدل پیش‌پرداخت تضمین می‌کند که هزینه‌ها قابل پیش‌بینی باقی بمانند و تعجب‌های اشتراک وجود نداشته باشد.

بالانس‌ها صرفاً از طریق ارزهای دیجیتال پردازش می‌شوند. می‌توانید هر مبلغ صحیحی از $20 تا $500 را با استفاده از USDT (TRC20) یا USDC (Base) واریز کنید. اعتبار پاداش به‌طور خودکار اعمال می‌شود: +5% از $50، +10% از $100 و +15% از $200. اعتبار پرداختی هرگز منقضی نمی‌شود، بنابراین می‌توانید یک بار شارژ کنید و در طول زمان از آن استفاده کنید.

حساب‌های جدید ۰.۵۰ دلار اعتبار آزمایشی دریافت می‌کنند که به مدت ۷ روز معتبر است. این به شما اجازه می‌دهد یکپارچه‌سازی را پیش از تعهد به واریز بزرگ‌تر بررسی کنید.

مبانی یکپارچه‌سازی

ابتدا یک درخواست POST به /v1/chat/completions ارسال کنید. از شناسه مدل "uncensored" برای دسترسی به مدل وزن‌باز واحد ما استفاده کنید. این مدل برای پاسخ دادن بدون رد محتوای قانونی برای بزرگسالان تنظیم شده است. این مدل GPT، Claude، Gemini یا هیچ مدل دیگری از فروشندگان نیست.

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

پارامترهای پشتیبانی‌شده شامل temperature، top_p، stop، seed، presence_penalty و frequency_penalty هستند. این پارامترها به شما امکان می‌دهند سبک پاسخ و قطعیت را بدون نیاز به اندپوینت‌های اضافی تنظیم کنید.

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

استریمینگ را با تنظیم stream به true در درخواست فعال کنید. پاسخ‌ها به صورت رویدادهای Server-Sent (SSE) دریافت می‌شوند. هر قطعه شامل متن جزئی است که به برنامه شما امکان می‌دهد خروجی را به صورت بلادرنگ نمایش دهد.

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

استریم با تمام SDKهای استاندارد OpenAI کار می‌کند. به سادگی base_url را به HTTPS://api.gemmaapikey.com/v1 به‌روزرسانی کنید. SDK پارس‌کردن SSE را به صورت خودکار مدیریت می‌کند. این به طور قابل توجهی کد boilerplate را نسبت به مدیریت دستی استریم کاهش می‌دهد.

فراخوانی تابع

API ما از function calling از طریق پارامتر tools پشتیبانی می‌کند. توابع خود را در درخواست تعریف کنید و مدل خروجی JSON ساختاریافته برای استفاده از ابزارها تولید خواهد کرد. این امکان جریان‌های کاری پیچیده مانند استخراج داده یا فعال‌سازی عملیات را فراهم می‌سازد.

tool_choice را روی "auto" یا یک تابع خاص تنظیم کنید. مدل این محدودیت‌ها را رعایت کرده و JSON معتد خروجی می‌دهد. از response_format با مقدار json_object برای انطباق سخت‌گیرانه با JSON استفاده کنید.

فراخوانی تابع برای ساخت دستیارهایی که با سیستم‌های خارجی تعامل دارند ایده‌آل است. این قابلیت به طور بی‌درنگ با مدل بدون سانسور کار می‌کند. به لایه مسیریابی جداگانه‌ای برای فعال‌سازی ابزارها نیاز ندارید. همان نقطه پایانی (Endpoint) هم گفتگو و هم فراخوانی تابع را مدیریت می‌کند.

مدیریت خطا

خطاها کدهای وضعیت HTTP استاندارد را برمی‌گردانند. خطاهای رایج شامل 429 برای محدودیت نرخ و 400 برای پارامترهای نامعتبر است. برای جزئیات به پیام خطا مراجعه کنید. رد شدن به دلیل سیاست‌های محتوا نادر است اما برای محتوای مرتبط با کودکان امکان‌پذیر است.

منطق تلاش مجدد برای خطاهای 429 را پیاده‌سازی کنید. محدودیت نرخ ما اجازه 300 درخواست در دقیقه به ازای هر کلید را می‌دهد. محدودیت‌های انفجاری اجازه 8 درخواست همزمان را می‌دهند. تجاوز از این محدودیت‌ها منجر به پاسخ 429 می‌شود. پیش از تلاش مجدد، کمی صبر کنید.

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

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

هر کلید API اجازه ۳۰۰ درخواست در دقیقه را می‌دهد. شما می‌توانید ۸ درخواست را همزمان اجرا کنید. حداکثر اندازه بدنه درخواست ۸ مگابایت است. این محدودیت‌ها عملکرد پایدار را برای اکثر موارد استفاده تضمین می‌کنند.

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

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

بهترین شیوه‌های امنیت

کلید API خود را امن نگه دارید. این کلید بلافاصله پس از ثبت‌نام نمایش داده می‌شود. آن را در متغیرهای محیطی ذخیره کنید، نه در کد سمت کلاینت. برای تمام درخواست‌ها از HTTPS استفاده کنید. API ما از هدرهای احراز هویت استاندارد استفاده می‌کند.

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

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