جدیدسرور MCP بنانا: مستندات، قیمت‌ها و تولید مستقیم داخل Claude و Cursor ←
پلتفرم توسعه‌دهندگانبنانا AIAPI

مسیرها

فهرست مدل‌های در دسترس

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

GEThttps://api.bananaai.ir/api/v1/models
نسخهٔ .md

همه مدل‌های عکس، ویدیو و گفتگو را با شناسه، مسیرهای پشتیبانی‌شده، گزینه‌ها و هزینه برمی‌گرداند. فقط‌خواندنی است و اعتباری کم نمی‌کند (اما در سهمیه نرخ درخواست حساب می‌شود).

Query params:

  • type (optional): image | video | chat | audio — فقط مدل‌های همان نوع.

نمونه curl

bash
curl "https://api.bananaai.ir/api/v1/models" \
  -H "Authorization: Bearer ba_live_your_api_key"
bash
curl "https://api.bananaai.ir/api/v1/models?type=chat" \
  -H "Authorization: Bearer ba_live_your_api_key"

پاسخ

json
{
  "object": "list",
  "data": [
    {
      "id": "nano-banana-2",
      "object": "model",
      "type": "image",
      "name": "Nano Banana 2",
      "description": "...",
      "endpoints": ["/api/v1/images/generations", "/api/v1/images/edits"],
      "pricing": {
        "unit": "per_image",
        "billing": "به ازای هر عکس، بر اساس کیفیت (resolution)",
        "rates": [{ "option": "1K", "credits": 6 }, { "option": "2K", "credits": 8 }]
      },
      "provider": "nanobanana",
      "aspect_ratios": ["1:1", "9:16", "16:9"],
      "resolutions": ["1K", "2K", "4K"],
      "supports_multiple_outputs": false
    },
    {
      "id": "seedance-2",
      "object": "model",
      "type": "video",
      "name": "Seedance 2.0",
      "endpoints": ["/api/v1/videos/generations", "/api/v1/videos/image-to-video"],
      "pricing": { "unit": "per_second", "billing": "...", "rates": [{ "option": "720p", "credits": 50 }] },
      "duration": { "min": 4, "max": 15, "step": 1, "default": 5 },
      "default_resolution": "720p",
      "default_aspect_ratio": "9:16",
      "supports_first_last_frame": true
    },
    {
      "id": "gpt-6-astra",
      "object": "model",
      "type": "chat",
      "name": "GPT 6 Astra",
      "endpoints": ["/api/v1/chat/completions"],
      "pricing": { "unit": "per_request", "billing": "...", "rates": [{ "option": "ثابت", "credits": 5 }] },
      "family": "gpt",
      "aliases": ["astra", "gpt-6"],
      "supports_vision": true,
      "credits_per_request": 5
    }
  ]
}

فیلدهای هر مدل

  • id: همان مقداری که در فیلد model درخواست می‌فرستید.
  • type: image | video | chat | audio.
  • endpoints: مسیرهایی که این مدل را می‌پذیرند.
  • pricing.unit: per_image | per_second | per_video | per_request | per_minute | per_characters؛ rates نرخ هر گزینه (کیفیت، رزولوشن، mode یا ثابت).
  • عکس: provider، aspect_ratios، resolutions (اگر مدل چند کیفیت دارد)، supports_multiple_outputs.
  • ویدیو: duration (min/max/step/default)، default_resolution، default_aspect_ratio، supports_first_last_frame.
  • گفتگو: family (gpt | claude | grok)، aliases، supports_vision، credits_per_request.
  • صدا: voices (شناسه‌ها برای voice_id)، default_voice_id، languages، limits.