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

`GET https://api.bananaai.ir/api/v1/models`


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

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`.