# Gemini Omni Text to Video

> ادغام مدل هوش مصنوعی gemini-omni-text-to-video از طریق API با کارایی بالا و تعرفه مصرف منعطف.

## نمای کلی

- **نقطه پایانی**: `POST https://api.muapi.ai/api/v1/gemini-omni-text-to-video`
- **مدل‌ها ID**: `gemini-omni-text-to-video`
- **دسته‌بندی**: متن به ویدیو
- **نسخه مدل**: Text to Video
- **خانواده مدل**: gemini-omni
- **هزینه**:  1.5 credits（مدل‌ها）

## API 

MuApi ****：， `request_id`，， `status`  `completed`。 `?webhook=YOUR_URL`， POST （）。

****： `x-api-key`  MuApi 。 https://muapi.ai/access-keys 。

### 1. 

```http
POST https://api.muapi.ai/api/v1/gemini-omni-text-to-video
Content-Type: application/json
x-api-key: YOUR_API_KEY
```

**（）：**

```json
{
  "prompt": "<prompt>"
}
```

**（همه）：**

```json
{
  "prompt": "<prompt>",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "audio_ids": [],
  "seed": 0,
  "character_ids": []
}
```

**：**

```json
{
  "request_id": "abc123",
  "status": "processing"
}
```

### 2. نتیجه

```http
GET https://api.muapi.ai/api/v1/predictions/{request_id}/result
x-api-key: YOUR_API_KEY
```

 `status` ：`queued`、`pending`、`processing`、`completed`、`failed`、`cancelled`。 2–5 ，。 `completed` ，نتیجه URL  `outputs` 。

**`completed` ：**

```json
{
  "id": "abc123",
  "status": "completed",
  "outputs": [
    "https://cdn.muapi.ai/.../output.png"
  ],
  "urls": {
    "get": "https://api.muapi.ai/api/v1/predictions/abc123/result"
  },
  "created_at": "2026-05-08T12:34:56Z",
  "has_nsfw_contents": []
}
```

### CURL

```bash
1. 
REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/gemini-omni-text-to-video \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"<prompt>"}' | jq -r .request_id)

2. 
while :; do
  RESP=$(curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY")
  STATUS=$(echo "$RESP" | jq -r .status)
  [ "$STATUS" = "completed" ] && echo "$RESP" | jq .outputs && break
  [ "$STATUS" = "failed" ] && echo "$RESP" && exit 1
  sleep 3
done
```

### پایتون

```python
import os, time, requests

API = "https://api.muapi.ai/api/v1"
headers = {"x-api-key": os.environ["MUAPI_API_KEY"]}

r = requests.post(f"{API}/gemini-omni-text-to-video", headers=headers, json={"prompt":"<prompt>"})
request_id = r.json()["request_id"]

while True:
    res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json()
    if res["status"] == "completed":
        print(res["outputs"]); break
    if res["status"] == "failed":
        raise RuntimeError(res.get("error")); 
    time.sleep(3)
```

## طرح ورودی (Input Schema)

API ：

- **`prompt`** (`string`, __):
  تنظیم پارامتر Text description of the desired video content. Gemini Omni supports rich multimodal prompts including scene composition, camera direction, dialogue, and ambient audio cues. جهت هدایت دقیق فرآیند تولید مدل.

- **`duration`** (`int`, __):
  مدت زمان ویدیوی خروجی بر حسب ثانیه.
  - پیش‌فرض: `8`
  - گزینه‌ها: `"4"`, `"6"`, `"8"`, `"10"`

- **`resolution`** (`string`, __):
  تنظیم پارامتر Output video resolution. Billed per second of output: $0.039/s at 360p, $0.13/s at 720p, $0.195/s at 1080p, $0.39/s at 4K. جهت هدایت دقیق فرآیند تولید مدل.
  - پیش‌فرض: `"1080p"`
  - گزینه‌ها: `"360p"`, `"720p"`, `"1080p"`, `"4k"`

- **`aspect_ratio`** (`string`, __):
  نسبت ابعاد تصویر خروجی (مانند 16:9 یا 1:1).
  - پیش‌فرض: `"16:9"`
  - گزینه‌ها: `"16:9"`, `"9:16"`

- **`audio_ids`** (`array`, __):
  حداکثر تا 3 voice profile IDs returned by the Gemini Omni Audio endpoint.

- **`seed`** (`int`, __):
  سید تصادفی (Seed) برای بازتولید دقیق خروجی.
  - پیش‌فرض: `0`

- **`character_ids`** (`array`, __):
  حداکثر تا 3 character IDs from Gemini Omni Character to feature in the video.

## طرح خروجی (Output Schema)

：

- **`id`** (`string`):  ID。
- **`status`** (`string`): ：`queued`、`pending`、`processing`、`completed`、`failed`、`cancelled`。
- **`outputs`** (`array`): تصویر、ویدیوصدا URL。`status`  `completed` 。
- **`urls.get`** (`string`): نتیجه。
- **`error`** (`string` | `null`): `status`  `failed` 。
- **`created_at`** (`string`):  ISO-8601 。
- **`has_nsfw_contents`** (`array of boolean`):  NSFW 。

## Webhook（）

 URL  `?webhook=https://your-server/path`。，MuApi  POST  URL，。

## Agent 

MuApi  MCP  CLI， Agent（Claude Code、Cursor  Agent） HTTP ：

```bash
#  CLI
npm install -g muapi-cli

# 
muapi auth login

#  MuApi مدل‌ها MCP  Agent
muapi mcp serve
```

MCP مدل‌ها， `gemini-omni-text-to-video`。 `muapi --help` （`muapi image generate`、`muapi video from-image` ）。

## مدل‌ها
- [تصویر به ویدیو](https://muapi.ai/fa/playground/gemini-omni-image-to-video)
- [Audio Profile](https://muapi.ai/fa/playground/gemini-omni-audio)
- [Character Creation](https://muapi.ai/fa/playground/gemini-omni-character)
- [1.1 Flash](https://muapi.ai/fa/playground/gemini-omni-flash-1-1-text-to-video)
- [متن به ویدیو](https://muapi.ai/fa/playground/gemini-omni-text-to-video)
- [Video Edit](https://muapi.ai/fa/playground/gemini-omni-video-edit)
- [1.1 Flash Image to Video](https://muapi.ai/fa/playground/gemini-omni-flash-1-1-image-to-video)
- [1.1 Flash Edit](https://muapi.ai/fa/playground/gemini-omni-flash-1-1-edit)
- [1.1 Flash Reference to Video](https://muapi.ai/fa/playground/gemini-omni-flash-1-1-reference-to-video)

## منابع و مستندات
- [زمین بازی](https://muapi.ai/fa/playground/gemini-omni-text-to-video)
- [API ](https://muapi.ai/fa/playground/gemini-omni-text-to-video/api)
- [ llms.txt](https://muapi.ai/fa/llms.txt)