# تولید ویدیو از متن (Text to Video)

`POST https://api.bananaai.ir/api/v1/videos/generations`


## مدل‌ها

- `kling-v3-turbo`: ۳ تا ۱۵ ثانیه، ۷۲۰p / ۱۰۸۰p
- `seedance-2`: ۴ تا ۱۵ ثانیه، تا ۴K
- `seedance-2-5`: ۴ تا ۳۰ ثانیه، ۴۸۰p / ۷۲۰p / ۱۰۸۰p
- `seedance-2-mini`: اقتصادی، فقط ۴۸۰p / ۷۲۰p
- `grok-imagine-video`: ۶ تا ۱۵ ثانیه، ۴۸۰p / ۷۲۰p
- `veo-3.1`: فقط مدت‌های ۴ / ۶ / ۸ ثانیه، تا ۴K (کیفیت از مدت: Lite / Fast / Quality). نسبت‌ها: ۱۶:۹ و ۹:۱۶

## درخواست

- `prompt` (required, string): متن توصیف ویدیو.
- `generate_audio` (optional, boolean): فقط Seedance: تولید صدا.
- `web_search` (optional, boolean): فقط Seedance: جستجوی وب.
- `model` (optional, string): شناسه مدل ویدیو.
  - examples: `veo-3.1`, `grok-imagine-video`, `kling-v3-turbo`, `wan-3`, `wan-3-prime`, `flux-3-video`, `kling-4`, `seedance-2-5`, `seedance-2`, `seedance-2-mini`, `gemini-omni-video`, `kling-3.0`
- `duration` (optional, integer): مدت زمان ویدیو به ثانیه. بازه مجاز به مدل بستگی دارد.
  - examples: `5`, `8`, `10`
- `resolution` (optional, string): رزولوشن خروجی. گزینه‌ها به مدل بستگی دارد.
  - examples: `480p`, `720p`, `1080p`, `4k`
- `aspect_ratio` (optional, string): نسبت عکس ویدیو.
  - examples: `16:9`, `9:16`, `1:1`, `auto`

### نمونه curl

```bash
curl -X POST "https://api.bananaai.ir/api/v1/videos/generations" \
  -H "Authorization: Bearer ba_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2","prompt":"A cinematic drone shot over misty mountains at sunrise","duration":5,"resolution":"720p","aspect_ratio":"9:16","generate_audio":false}'
```

## پاسخ

```json
{
  "id": "task_abc123",
  "status": "pending",
  "model": "seedance-2",
  "credits_reserved": 250,
  "created_at": "2026-01-01T12:00:00.000Z"
}
```

> شناسه task در فیلد `id` است. وقتی وضعیت `completed` شد، فیلد `videos` شامل URL خروجی است. پیگیری با `GET /api/v1/tasks/:id` هر ۳ تا ۵ ثانیه.