SambaNova Cloud API رایگان

هدف استفاده و نیت جست‌وجو

SambaNova Cloud برای اجرای سریع Chat Completions، Responses و قابلیت‌های سازگار با OpenAI روی مدل‌های میزبانی‌شده مناسب است. این راهنما ساخت API Key، اولین درخواست امن، تفاوت Free Tier و Developer Tier و مدیریت خطاهای رسمی 401، 410 و 429 را پوشش می‌دهد؛ وضعیت ایران از Evidence تاریخ‌دار Catalog حفظ می‌شود.

مراحل ثبت‌نام

1. در SambaCloud حساب بسازید و از بخش API یک کلید جدید ایجاد کنید. کلید پس از ساخت دوباره نمایش داده نمی‌شود؛ آن را فوراً در secret manager یا متغیر محیطی SAMBANOVA_API_KEY ذخیره کنید.
2. مدل را از فهرست رسمی SambaCloud انتخاب کنید و مشخص کنید Production است یا Preview. Preview برای ارزیابی و آزمایش است و می‌تواند با ظرفیت محدود یا حذف کوتاه‌مدت همراه باشد.
3. پیش از مصرف واقعی، Rate Limits همان tier و پاسخ headerهای محدودیت را بررسی کنید. Free Tier برای حساب بدون روش پرداخت اعمال می‌شود و محدودیت RPM، RPD و TPD می‌تواند مدل‌به‌مدل متفاوت باشد.

نمونه اولین درخواست API

curl https://api.sambanova.ai/v1/chat/completions \
  -H "Authorization: Bearer $SAMBANOVA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-oss-120b","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}]}'

مدل gpt-oss-120b در فهرست رسمی و Evidence فعلی Catalog ثبت شده است. API Key واقعی فقط از متغیر محیطی خوانده شود و پیش از استقرار، مدل و tier حساب دوباره کنترل شوند.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16

خطاهای رایج و رفع اشکال

• 401 — کلید نامعتبر، منقضی یا ارسال‌نشده

  هدر Bearer و SAMBANOVA_API_KEY را بررسی کنید. کلید افشاشده را از Portal حذف و کلید جدید بسازید؛ مقدار کلید یا پاسخ کامل دارای اطلاعات حساس را در issue عمومی قرار ندهید. منبع رسمی (2026-07-16)

• 410 — مدل حذف یا منسوخ شده است

  فهرست مدل‌های SambaCloud و صفحه Deprecations را بررسی کنید و شناسه درخواست را به مدل پشتیبانی‌شده تغییر دهید. به نام مدل‌های قدیمی در نمونه‌کدهای cache‌شده تکیه نکنید. منبع رسمی (2026-07-16)

• 429 — Rate limit، quota یا queue پر شده است

  RPM، RPD و TPD را از headerهای پاسخ و جدول رسمی tier بخوانید، concurrency را کم کنید و retry را با exponential backoff و jitter اجرا کنید. queue_full را با ارسال هم‌زمان بیشتر تشدید نکنید. منبع رسمی (2026-07-16)

چه زمانی این Provider انتخاب مناسبی نیست؟

• زمانی که پروژه به تعداد زیاد درخواست روزانه در پلن رایگان نیاز دارد؛ RPD می‌تواند پیش از RPM یا TPD محدودکننده شود.
• زمانی که ویژگی‌های OpenAI بدون اختلاف رفتاری لازم‌اند؛ بعضی پارامترها پشتیبانی نمی‌شوند یا محدودیت متفاوت دارند و باید با Compatibility Guide تطبیق داده شوند.
• زمانی که پروژه نمی‌تواند تغییر یا حذف مدل‌های Preview را تحمل کند؛ برای production فقط مدل و tier مناسب با برنامه مهاجرت انتخاب شود.

راهنماهای مرتبط

• openai-sdk-custom-base-url
• free-tier-vs-trial-vs-credit
• free-coding-api

آخرین بازبینی محتوای این صفحه: 2026-07-16