صفحه اختصاصی Provider

Fireworks AI API رایگان

اطلاعات Fireworks AI: سهمیه رایگان، روش اتصال (وضعیت اتصال نامشخص) و پیش‌نیاز حساب (نیاز به تکمیل شرایط ثبت‌نام) با منبع و تاریخ بررسی.

وضعیت اتصال نامشخصآخرین بررسی: 2026-08-07

خلاصه فنی

نوع سهمیه: اعتبار یک‌باره
محدودیت نمونه: وابسته به مدل یا حساب
سازگار با OpenAI: بله
روش اتصال از ایران: وضعیت اتصال نامشخص
پیش‌نیاز حساب: نیاز به تکمیل شرایط ثبت‌نام
Base URL: https://api.fireworks.ai/inference/v1

قابلیت‌ها

مدل‌های شاخص

llama-3.3-70b، gpt-oss-120b، deepseek-v4-flash، qwen3-7b-plus، gemma-3n-4b

نکات مهم

Fireworks برای حساب‌های self-serve از سیستم اعتبار پیش‌پرداخت استفاده می‌کند. کاربر جدید طبق منبع رسمی ۱ دلار اعتبار اولیه دریافت می‌کند. اگر موجودی به صفر برسد و Auto Reload فعال نباشد، استفاده متوقف می‌شود تا اعتبار اضافه شود. برای ادامه پس از پایان اعتبار اولیه، روش پرداخت لازم است.

بازبینی ۲۰۲۶-۰۸-۰۷ فقط مستندات رسمی Billing، اعتبار و Rate Limit را تازه کرد. وضعیت Credential، حساب و دسترسی ایران دوباره تست نشد و Evidence تاریخ‌دار قبلی بدون تغییر معنایی حفظ شده است.

ثبت‌نام با حساب آزمایش‌شده به محدودیت سطح حساب منتهی شد. مسیر مستقیم ایران نیز در چند Probe با Timeout، Connection refused یا network_error شکست خورده است. به‌دلیل نبود یک Credential کنترل‌شده و موفق، این نتایج نباید به‌عنوان اثبات قطعی Geo-blocking یا ابطال Credential تفسیر شوند.

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

Fireworks AI برای آزمایش سریع مدل‌های متن‌باز با endpoint سازگار با OpenAI، streaming، Tool Calling و Structured Output مناسب است. کاربر جدید طبق منبع رسمی ۱ دلار اعتبار اولیه دریافت می‌کند و حساب‌های self-serve روی سیستم اعتبار پیش‌پرداخت کار می‌کنند. بدون روش پرداخت یا بدون اعتبار، سقف سراسری حساب ۱۰ RPM است؛ با روش پرداخت و اعتبار فعال سقف سراسری تا ۶٬۰۰۰ RPM می‌رسد و Serverless علاوه بر آن محدودیت‌های تطبیقی TPM دارد. وضعیت ایران در Catalog نامشخص باقی می‌ماند، زیرا Evidence فعلی میان وضعیت حساب و محدودیت شبکه تفکیک قطعی ایجاد نمی‌کند.

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

در Fireworks حساب بسازید و از Dashboard یک API Key ایجاد کنید. مقدار کلید را در FIREWORKS_API_KEY یا secret manager قرار دهید و هرگز آن را در کد frontend، فایل عمومی یا log چاپ نکنید.
مدل Serverless فعال را از Model Library انتخاب کنید و شناسه کامل `accounts/fireworks/models/...` را کپی کنید. نام کوتاه یا شناسه مدل سایر Gatewayها الزاماً در Fireworks معتبر نیست.
پیش از workload اصلی، موجودی اعتبار، تنظیمات Prepaid/Auto Reload، سقف درخواست سطح حساب و محدودیت‌های Serverless TPM را کنترل کنید. پس از پایان اعتبار اولیه، برای ادامه استفاده باید روش پرداخت اضافه و اعتبار تأمین شود.

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

curl https://api.fireworks.ai/inference/v1/chat/completions \
  -H "Authorization: Bearer $FIREWORKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"accounts/fireworks/models/deepseek-v3p1","messages":[{"role":"user","content":"سلام! در یک جمله پاسخ بده."}]}'

Fireworks با OpenAI SDK سازگار است، اما شناسه مدل باید از Catalog رسمی خود Fireworks برداشته شود. موجودبودن مدل، قیمت و اعتبار حساب را پیش از اجرای مجدد بررسی کنید.

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

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

400 — درخواست یا شناسه مدل نامعتبر است
ساختار messages و پارامترها را با Chat Completions تطبیق دهید، شناسه کامل مدل را از Model Library بگیرید و برای تشخیص خطا ابتدا درخواست را به model و messages حداقلی کاهش دهید. منبع رسمی (2026-08-07)
401/403 — کلید، مجوز یا وضعیت حساب مشکل دارد
هدر Bearer و FIREWORKS_API_KEY را بررسی کنید و وضعیت فعال‌بودن حساب را در Dashboard ببینید. Evidence فعلی پروژه وضعیت ایران را قطعی نمی‌کند؛ بنابراین 403 را بدون مقایسه Credential فعال به Geo-block نسبت ندهید. منبع رسمی (2026-08-07)
402/429 — اعتبار، Billing یا Rate Limit مشکل دارد
برای 402 موجودی Prepaid، روش پرداخت و وضعیت Billing را بررسی کنید. در Serverless، 429 می‌تواند از سقف درخواست سطح حساب یا محدودیت تطبیقی TPM ناشی شود؛ concurrency و burst را کاهش دهید، headerهای Rate Limit را بررسی کنید و از exponential backoff استفاده کنید. 429 روی deployment اختصاصی می‌تواند نشانه اشباع ظرفیت باشد و الزاماً quota حساب نیست. منبع رسمی (2026-08-07)

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

زمانی که پروژه به سهمیه رایگان تکرارشونده نیاز دارد؛ ۱ دلار اعتبار اولیه یک اعتبار محدود شروع کار است و سهمیه ماهانه تکرارشونده نیست.
زمانی که دسترسی مستقیم تأییدشده از ایران شرط انتخاب است؛ Evidence فعلی به‌دلیل وضعیت حساب و نتایج متناقض برای طبقه‌بندی قطعی کافی نیست.
زمانی که برنامه به رفتار کاملاً یکسان OpenAI نیاز دارد؛ Fireworks سازگار است اما در context-length، usage streaming و برخی پارامترها تفاوت‌های مستند دارد.

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

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

منابع بررسی

APIهای مرتبط

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