خرید API هوش مصنوعی با پرداخت تومانی؛ چک‌لیست قبل از خرید

قدم اول: API را برای چه کاری می‌خواهید؟

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

بعد از مشخص‌شدن کاربرد، ابزار را انتخاب کنید. بعضی ابزارها پروتکل بومی سازنده مدل را می‌خواهند و بعضی دیگر با endpoint سازگار با OpenAI کار می‌کنند. یک کلید API به‌تنهایی تضمین نمی‌کند هر ابزاری با آن کار کند؛ باید بدانید ابزار شما کدام مسیر را صدا می‌زند.

• برای اپلیکیشن‌های خودنویس، معمولاً مسیر سازگار با OpenAI کافی است.
• برای ابزارهایی که مخصوص یک خانواده مدل ساخته شده‌اند، مسیر بومی همان خانواده را بررسی کنید.
• اگر ابزار هر دو مسیر را پشتیبانی می‌کند، مسیری را انتخاب کنید که قابلیت‌های بیشتری از مدل را در دسترس می‌گذارد.

سازگاری ابزار را چطور آزمایش کنیم؟

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

curl https://cyno.ir/v1/models \
  -H "Authorization: Bearer $CYNO_API_KEY"

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

قیمت API را چطور مقایسه کنیم؟

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

1. تعداد توکن ورودی و خروجی یک درخواست نمونه را تخمین بزنید.
2. تعداد توکن هر بخش را بر واحد تعرفه تقسیم کنید (مثلاً یک میلیون)، در نرخ همان بخش ضرب کنید و نتیجه‌ها را جمع کنید.
3. هزینه تلاش دوباره و خروجی‌های نامعتبر را به جمع اضافه کنید.
4. حاصل را بر تعداد پاسخ‌های قابل استفاده تقسیم کنید.

پرداخت تومانی چه تفاوتی ایجاد می‌کند؟

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

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

کلید API را کجا نگه داریم؟

کلید API مانند رمز عبور کیف پول است. آن را در متغیر محیطی سمت سرور نگه دارید و از یک کلید جداگانه برای محیط توسعه و تولید استفاده کنید. اگر کلید اشتباهاً در مخزن عمومی قرار گرفت، آن را باطل و از نو بسازید؛ حذف فایل از آخرین کامیت کافی نیست.

export CYNO_API_KEY="..."
# این متغیر را در سمت کلاینت استفاده نکنید.

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

از کجا شروع کنیم؟

مسیر پیشنهادی این است: تعرفه مدل مورد نظرتان را در صفحه قیمت‌گذاری ببینید، یک اعتبار کوچک بخرید، با یک درخواست ساده اتصال را تأیید کنید و بعد مصرف واقعی را برای یک هفته ثبت کنید. با این داده‌ها می‌توانید حجم خرید بعدی را دقیق‌تر انتخاب کنید.

اگر در گام اتصال به مشکل خوردید، آموزش شروع سریع و بخش خطاها را ببینید؛ بیشتر خطاهای رایج دلیل مشخصی دارند و با یک تغییر کوچک در تنظیمات حل می‌شوند.