# BananaAI API

> One API key for BananaAI image, video, chat and audio models, billed in credits and paid in Toman. Docs are in Persian; code is universal.

- Base URL: https://api.bananaai.ir/api/v1
- Auth: Authorization: Bearer ba_live_your_api_key
- MCP server (Streamable HTTP): https://api.bananaai.ir/mcp
- Keys: https://api.bananaai.ir/console

## Docs

### شروع کار

- [معرفی API بنانا AI](https://api.bananaai.ir/md/overview.md): تولید و ویرایش عکس و ویدیو را با همان مدل‌های استودیو به محصول خود اضافه کنید. درخواست‌ها ناهمگام پردازش می‌شوند و اعتبار فقط پس از تولید موفق کسر می‌شود.
- [احراز هویت](https://api.bananaai.ir/md/authentication.md): هر درخواست باید یک کلید API معتبر در هدر Authorization داشته باشد. در این صفحه ساختار کلید، هدر Idempotency-Key و نکات امنیتی را می‌بینید.
- [حساب و اعتبار](https://api.bananaai.ir/md/account.md): پیش از ثبت درخواست، موجودی اعتبار، پلن فعال و سقف نرخ درخواست حساب خود را بخوانید. این مسیر فقط‌خواندنی است و اعتباری مصرف نمی‌کند.
- [اتصال MCP](https://api.bananaai.ir/md/mcp.md): سرور MCP بنانا AI مستندات و ابزارهای تولید را در اختیار Cursor، Claude Code، Codex و هر کلاینت سازگار با Model Context Protocol قرار می‌دهد.

### مسیرها

- [تولید عکس](https://api.bananaai.ir/md/images/generations.md): با ارسال یک پرامپت متنی، یک یا چند عکس جدید بسازید. مدل، نسبت تصویر و کیفیت خروجی را در بدنهٔ درخواست تعیین کنید.
- [ویرایش عکس](https://api.bananaai.ir/md/images/edits.md): یک یا چند عکس مرجع را همراه با پرامپت بفرستید و نسخه‌ای تازه از آن‌ها بسازید؛ تغییر سبک، حذف یا افزودن عناصر و ترکیب چند عکس.
- [تولید ویدیو از متن](https://api.bananaai.ir/md/videos/generations.md): از یک توضیح متنی ویدیو بسازید. مدل، مدت، رزولوشن و نسبت تصویر را انتخاب کنید و نتیجه را از مسیر پیگیری تسک دریافت کنید.
- [تولید ویدیو از عکس](https://api.bananaai.ir/md/videos/image-to-video.md): یک یا چند عکس مرجع را همراه با توضیحی کوتاه بفرستید تا به ویدیو تبدیل شود. از فریم اول و آخر، ورودی‌های مرجع چندرسانه‌ای و ویرایش ویدیو پشتیبانی می‌شود.
- [گفتگو با مدل‌های زبانی (Chat Completions)](https://api.bananaai.ir/md/chat/completions.md): با GPT 6 Astra، Claude Haiku 5.5، Claude Opus 5.5، Grok 4.7، Gemini 3.5 Flash-Lite و بقیهٔ مدل‌ها گفتگو کنید. فرمت درخواست و پاسخ با OpenAI Chat Completions سازگار است و پاسخ همان لحظه برمی‌گردد.
- [متن به گفتار (Text to Speech)](https://api.bananaai.ir/md/audio/speech.md): متن فارسی یا انگلیسی را با گویندگان فارسی‌زبان به صدا تبدیل کنید؛ تک‌گوینده یا دیالوگ چندنفره با تگ‌های حسی. فایل صوتی همان لحظه برمی‌گردد.
- [گفتار به متن (Speech to Text)](https://api.bananaai.ir/md/audio/transcriptions.md): فایل صوتی یا ویدیویی را به متن تبدیل کنید؛ با تشخیص خودکار زبان، زمان‌بندی هر کلمه و تفکیک گوینده. متن همان لحظه برمی‌گردد.
- [دوبله صوت و ویدیو (Dubbing)](https://api.bananaai.ir/md/audio/dubbing.md): صوت یا ویدیو را با حفظ صدای گوینده‌ها به زبان دیگری دوبله کنید؛ مثلاً ویدیوی انگلیسی به فارسی. تسک ناهمگام است و نتیجه را از مسیر پیگیری تسک می‌گیرید.
- [فهرست مدل‌های در دسترس](https://api.bananaai.ir/md/models.md): همه مدل‌های عکس، ویدیو، گفتگو و صدا را با شناسه، مسیرهای پشتیبانی‌شده، گزینه‌ها و هزینه به‌صورت برنامه‌نویسی بخوانید. این مسیر فقط‌خواندنی است و اعتباری مصرف نمی‌کند.
- [پیگیری وضعیت تسک](https://api.bananaai.ir/md/tasks.md): هر درخواست تولید یک تسک ناهمگام می‌سازد. وضعیت تسک را با شناسهٔ آن پیگیری کنید یا فهرست تسک‌های اخیر حساب را با فیلتر زمان و وضعیت بگیرید.
- [وب‌هوک‌ها: دریافت خودکار نتیجه](https://api.bananaai.ir/md/webhooks.md): به‌جای پیگیری مداوم، نتیجهٔ هر تسک به‌محض آماده شدن با یک درخواست امضاشده به سرور شما ارسال می‌شود. رویدادها، ساختار بدنه، بررسی امضا و تلاش مجدد.

### مرجع

- [اعتبار و هزینه](https://api.bananaai.ir/md/pricing.md): هزینهٔ هر درخواست بر اساس مدل، کیفیت و در مدل‌های ویدیویی، مدت‌زمان محاسبه می‌شود. نرخ دقیق هر گزینه را در جدول‌های زیر ببینید یا با ماشین‌حساب تخمین بزنید.
- [خطاها و پیام‌ها](https://api.bananaai.ir/md/errors.md): همهٔ خطاها با یک ساختار JSON یکسان برمی‌گردند. کدهای خطا، وضعیت HTTP هر کدام و روش درست مدیریت ۴۲۹ و خطاهای اعتبار را اینجا ببینید.

## Models

- `nano-banana-2` (image) Nano Banana 2: از ۱۱٫۹ اعتبار · هر عکس
- `nano-banana-2-1` (image) Nano Banana 2.1: از ۶ اعتبار · هر عکس
- `nano-lite` (image) Nano Banana Lite: ۶ اعتبار · هر عکس
- `nano-pro` (image) Nano Banana Pro: از ۲۶٫۸ اعتبار · هر عکس
- `grok-speed` (image) Grok Imagine: ۶ اعتبار · هر عکس
- `grok-quality` (image) Grok Imagine Pro: ۷٫۵ اعتبار · هر عکس
- `gpt-image-2-5-flare` (image) GPT Image 2.5 Flare: از ۹ اعتبار · هر عکس
- `gpt-image-2-5-sunburst` (image) GPT Image 2.5 Sunburst: از ۹ اعتبار · هر عکس
- `seedream-5-pro` (image) Seedream 5 Pro: از ۱۰٫۴ اعتبار · هر عکس
- `flux-3-image` (image) FLUX 3 Image: از ۱۰ اعتبار · هر عکس
- `wan-3` (video) Wan 3.0: از ۹٫۸ اعتبار · هر ثانیه
- `wan-3-prime` (video) Wan 3.0 Prime: از ۱۵٫۸ اعتبار · هر ثانیه
- `seedance-2-5` (video) Seedance 2.5: از ۲۹٫۶ اعتبار · هر ثانیه
- `seedance-2` (video) Seedance 2.0: از ۲۰٫۶ اعتبار · هر ثانیه
- `seedance-2-mini` (video) Seedance 2.0 Mini: از ۵٫۵ اعتبار · هر ثانیه
- `grok-imagine-video` (video) Grok Imagine Video 1.5: از ۳٫۱ اعتبار · هر ثانیه
- `veo-3.1` (video) Google Veo 3.1: از ۴۵٫۶ اعتبار · هر ویدیو
- `gemini-omni-video` (video) Gemini Omni 1.1 Flash: از ۴۵ اعتبار · هر ویدیو
- `kling-3.0` (video) Kling 3.0: از ۲۱٫۹ اعتبار · هر ثانیه
- `kling-v3-turbo` (video) Kling 3 Turbo: از ۲۷٫۶ اعتبار · هر ثانیه
- `gpt-6-luna` (chat) GPT 6 Luna: ورودی ۲۳٫۷۶ · خروجی ۱۱۸٫۸ اعتبار / ۱M توکن
- `gpt-6.1-terra` (chat) GPT 6.1 Terra: ورودی ۲۳۷٫۶ · خروجی ۱٬۱۸۸ اعتبار / ۱M توکن
- `gpt-6.1-sol` (chat) GPT 6.1 Sol: ورودی ۴۷۵٫۲ · خروجی ۲٬۳۷۶ اعتبار / ۱M توکن
- `gpt-6-astra` (chat) GPT 6 Astra: ورودی ۲٬۳۷۶ · خروجی ۱۱٬۸۸۰ اعتبار / ۱M توکن
- `claude-haiku-5-5` (chat) Claude Haiku 5.5: ورودی ۲۳٫۷۶ · خروجی ۱۱۸٫۸ اعتبار / ۱M توکن
- `claude-sonnet-5-5` (chat) Claude Sonnet 5.5: ورودی ۴۷۵٫۲ · خروجی ۲٬۳۷۶ اعتبار / ۱M توکن
- `claude-opus-5-5` (chat) Claude Opus 5.5: ورودی ۹۵۰٫۴ · خروجی ۴٬۷۵۲ اعتبار / ۱M توکن
- `claude-sonnet-5` (chat) Claude Sonnet 5: ورودی ۴۷۵٫۲ · خروجی ۲٬۳۷۶ اعتبار / ۱M توکن
- `claude-opus-5` (chat) Claude Opus 5: ورودی ۱٬۱۸۸ · خروجی ۵٬۹۴۰ اعتبار / ۱M توکن
- `grok-4.7` (chat) Grok 4.7: ورودی ۴۷۵٫۲ · خروجی ۱٬۴۲۵٫۶ اعتبار / ۱M توکن
- `gemini-3.5-flash-lite` (chat) Gemini 3.5 Flash-Lite: ورودی ۸۹٫۱ · خروجی ۷۴۲٫۵ اعتبار / ۱M توکن
- `eleven_v4` (audio) Text to Speech: ۰٫۶۳ اعتبار · هر 30 کاراکتر متن
- `scribe_v2` (audio) Speech to Text: ۱٫۱ اعتبار · هر دقیقهٔ صوت
- `elevenlabs-dubbing` (audio) Dubbing: ۱۴۸٫۷ اعتبار · هر دقیقهٔ فایل ورودی