رفتن به محتوای اصلی
مستندات APIمسیرهاRead-only

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

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

مسیر درخواست

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

فهرست همهٔ مدل‌هایی که API می‌پذیرد را برمی‌گرداند؛ در حال حاضر 10 مدل عکس، 10 مدل ویدیو، 9 مدل گفتگو و 3 مدل صدا. برای هر مدل شناسه، مسیرهای پشتیبانی‌شده، گزینه‌های مجاز و جدول هزینه می‌آید؛ همان داده‌ای که صفحهٔ اعتبار و هزینه نمایش می‌دهد. این مسیر فقط‌خواندنی است و اعتباری کسر نمی‌کند، اما در سهمیهٔ نرخ درخواست حساب می‌شود.

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

پارامترهای query (همه اختیاری):

typestringاختیاری
فقط مدل‌های یک نوع را برگردان.
مقادیر مجاز:imagevideochataudio
bash
curl "https://bananaai.ir/api/v1/models?type=chat" \
  -H "Authorization: Bearer ba_live_your_api_key"

پاسخ

آرایهٔ data برای هر مدل یک آبجکت دارد. نمونهٔ زیر از داده‌های واقعی ساخته شده و یک مدل از هر نوع را نشان می‌دهد:

JSON
1{
2  "object": "list",
3  "data": [
4    {
5      "id": "nano-banana-2",
6      "object": "model",
7      "type": "image",
8      "name": "Nano Banana 2",
9      "description": "تعادل خوب بین کیفیت و سرعت. مناسب کار روزانه و پرامپت فارسی تا ۴K.",
10      "endpoints": [
11        "/api/v1/images/generations",
12        "/api/v1/images/edits"
13      ],
14      "pricing": {
15        "unit": "per_image",
16        "billing": "به ازای هر عکس، بر اساس کیفیت (resolution)",
17        "rates": [
18          {
19            "option": "1K",
20            "credits": 8
21          },
22          {
23            "option": "2K",
24            "credits": 12
25          },
26          {
27            "option": "4K",
28            "credits": 18
29          }
30        ]
31      },
32      "provider": "nanobanana",
33      "aspect_ratios": [
34        "1:1",
35        "9:16",
36        "16:9",
37        "3:4",
38        "4:3",
39        "3:2",
40        "2:3",
41        "5:4",
42        "4:5",
43        "21:9"
44      ],
45      "resolutions": [
46        "1K",
47        "2K",
48        "4K"
49      ],
50      "supports_multiple_outputs": false
51    },
52    {
53      "id": "wan-3",
54      "object": "model",
55      "type": "video",
56      "name": "Wan 3.0",
57      "description": "مدل همه‌کاره علی‌بابا: متن به ویدیو، فریم اول/آخر و مرجع تصویر و ویدیو. تا ۳۰ ثانیه در ۴۸۰p، ۷۲۰p و ۱۰۸۰p.",
58      "endpoints": [
59        "/api/v1/videos/generations",
60        "/api/v1/videos/image-to-video"
61      ],
62      "pricing": {
63        "unit": "per_second",
64        "billing": "اعتبار × مدت (ثانیه)، بر اساس رزولوشن",
65        "rates": [
66          {
67            "option": "480p",
68            "credits": 9
69          },
70          {
71            "option": "720p",
72            "credits": 18
73          },
74          {
75            "option": "1080p",
76            "credits": 35
77          }
78        ],
79        "notes": [
80          "۴۸۰p، ۷۲۰p و ۱۰۸۰p؛ حداقل ۲ ثانیه، حداکثر ۳۰ ثانیه.",
81          "صدا روشن یا خاموش قیمت را عوض نمی‌کند.",
82          "با ویدیوی مرجع، جمع مدت ورودی و خروجی نباید بیشتر از ۳۰ ثانیه باشد."
83        ]
84      },
85      "duration": {
86        "min": 2,
87        "max": 30,
88        "step": 1,
89        "default": 5
90      },
91      "default_resolution": "720p",
92      "default_aspect_ratio": "16:9",
93      "supports_first_last_frame": true
94    },
95    {
96      "id": "gpt-6-astra",
97      "object": "model",
98      "type": "chat",
99      "name": "GPT 6 Astra",
100      "description": "قوی‌ترین استدلال؛ مناسب مسائل پیچیده و متن‌های طولانی.",
101      "endpoints": [
102        "/api/v1/chat/completions"
103      ],
104      "pricing": {
105        "unit": "per_request",
106        "billing": "به ازای هر درخواست، نرخ ثابت (مستقل از طول پیام)",
107        "rates": [
108          {
109            "option": "ثابت",
110            "credits": 5
111          }
112        ],
113        "notes": [
114          "نام‌های کوتاه پذیرفته‌شده: `astra`، `gpt-6`، `gpt6-astra`"
115        ]
116      },
117      "family": "gpt",
118      "aliases": [
119        "astra",
120        "gpt-6",
121        "gpt6-astra"
122      ],
123      "supports_vision": true,
124      "credits_per_request": 5,
125      "billed_by_usage": false
126    }
127  ]
128}

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

idstring
همان مقداری که در فیلد model درخواست‌ها می‌فرستید.
typestring
نوع مدل.
مقادیر مجاز:imagevideochataudio
endpointsstring[]
مسیرهای /api/v1 که این مدل را می‌پذیرند.
pricingobject
unit یکی از per_image، per_second، per_video، per_request، per_minute یا per_characters؛ rates نرخ هر گزینه (کیفیت، رزولوشن، mode یا ثابت) و notes نکات تکمیلی مثل نرخ ورودی ویدیو.
provider · aspect_ratios · resolutions · supports_multiple_outputsimage
فقط مدل‌های عکس: ارائه‌دهنده، نسبت‌های مجاز، کیفیت‌های موجود (اگر مدل چند کیفیت دارد) و پشتیبانی از چند خروجی.
duration · default_resolution · default_aspect_ratio · supports_first_last_framevideo
فقط مدل‌های ویدیو: بازهٔ مدت (min/max/step/default)، پیش‌فرض‌ها و پشتیبانی از فریم اول/آخر.
family · aliases · supports_vision · credits_per_requestchat
فقط مدل‌های گفتگو: خانوادهٔ مدل (gpt / claude / grok)، نام‌های کوتاه پذیرفته‌شده، پشتیبانی از عکس ورودی و اعتبار ثابت هر درخواست.
voices · default_voice_id · languages · limitsaudio
فقط مدل‌های صدا: گویندگان متن به گفتار (شناسه‌ای که در voice_id می‌فرستید)، زبان‌های پشتیبانی‌شدهٔ رونویسی و دوبله، و سقف کاراکتر، مدت و حجم فایل.

نکته

فهرست مدل‌ها را در سمت خودتان کش کنید و روزانه تازه کنید؛ مدل‌های جدید و تغییر نرخ‌ها ابتدا در همین مسیر منعکس می‌شود. برای فرمت سازگار با OpenAI، همین پاسخ فیلدهای object: "list" و object: "model" را هم دارد.