شروع سریع
از صفحه «هوش مصنوعی» یک کلید جدا برای محیط برنامه بسازید. مقدار کامل کلید فقط یکبار نمایش داده میشود؛ آن را در Secret یا متغیر محیطی نگه دارید و داخل کد یا Git قرار ندهید.
curl https://paasta.cloud/api/ai/v1/chat/completions \
-H "Authorization: Bearer $PAASTA_AI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"MODEL_ID","messages":[{"role":"user","content":"Hello"}],"max_tokens":512}'مدل و قیمت
فهرست زنده مدلها از GET /api/ai/v1/models و صفحه هوش مصنوعی در دسترس است. قیمت نهایی ورودی و خروجی برای یک میلیون توکن به تومان نمایش داده میشود. هزینه واقعی پس از پاسخ موفق بر اساس usage ثبتشده کم میشود.
رزرو هزینه
پیش از ارسال، سقف محافظهکارانه هزینه با توجه به بدنه درخواست و max_tokens رزرو میشود. در خطای سرویس کل رزرو و پس از پاسخ موفق بخش مصرفنشده فوراً به موجودی برمیگردد. برای retry یک Idempotency-Key یکتا بفرستید.
سازگاری نسخه اولیه
مسیر chat/completions و فهرست مدلها با قالب OpenAI سازگارند. در نسخه اولیه پاسخ جریانی فعال نیست؛ مقدار stream را false بگذارید.
رفع خطا
- insufficient_credit: موجودی کیف پول را افزایش یا سقف خروجی را کمتر کنید.
- model_not_found: شناسه را از کاتالوگ زنده کپی کنید.
- rate_limit_exceeded: تا زمان اعلامشده صبر و سپس با همان منطق retry برنامه تلاش کنید.