مستندات APIشروع کارRead-only

حساب و اعتبار

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

نسخهٔ API: v1

مسیر درخواست

GEThttps://bananaai.ir/api/v1/account

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

نمونه درخواست

bash

curl "https://bananaai.ir/api/v1/account" \
  -H "Authorization: Bearer ba_live_your_api_key"

پاسخ

JSON

1{
2  "credits": 1200,
3  "credits_plan": 800,
4  "credits_bonus": 400,
5  "plan": "studio",
6  "plan_end_at": "2026-09-01T00:00:00.000Z",
7  "rate_limit_per_minute": 60
8}

creditsinteger: مجموع اعتبار قابل استفاده؛ برابر جمع credits_plan و credits_bonus.
credits_planinteger: اعتبار ماهانهٔ پلن فعال.
credits_bonusinteger: اعتبار خریداری‌شده یا هدیه که با پایان پلن از بین نمی‌رود.
planstring: پلن فعال فعلی حساب.; مقادیر مجاز:freeexplorercreatorstudioultra
plan_end_atstring | null: زمان پایان پلن به قالب ISO 8601، یا null اگر پلن زمان‌دار نیست.
rate_limit_per_minuteinteger: سقف درخواست در دقیقه برای این کلید، بر اساس پلن فعال. جدول کامل در محدودیت تعداد درخواست.

نکته

هزینهٔ هر مدل را در اعتبار و هزینه ببینید. اگر اعتبار کافی نباشد، درخواست تولید با 403 و کد insufficient_credits رد می‌شود و تسکی ساخته نمی‌شود.