@runapi.ai/gemini-omni-mcp

text_to_video

Create a Gemini Omni text-to-video task on RunAPI from a prompt and get back a task ID, status, and output URLs for polling or webhook delivery.

Instructions

Create a Gemini Omni task on RunAPI (text to video). Returns a task id, status, and output URLs.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "prompt": "<prompt>"
    },
    "name": "text_to_video"
  }
}

Input Schema

Name	Required	Description
`seed`	No	Deterministic generation seed. Declared type: integer.
`wait`	No	Poll until the task reaches a terminal status.
`model`	No	RunAPI model slug for this model line.
`prompt`	Yes	Video generation prompt. Declared type: string.
`audio_ids`	No	Audio preset IDs returned by create-audio. Declared type: array.
`timeout_ms`	No
`video_list`	No	Source video clips; each clip consumes two reference units. Declared type: array.
`aspect_ratio`	No	Output aspect ratio. Declared type: string. Known values: "16:9", "9:16".
`callback_url`	No	Webhook URL for terminal Task delivery. Declared type: string.
`character_ids`	No	Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units. Declared type: array.
`duration_seconds`	No	Output duration in seconds. Declared type: integer.
`poll_interval_ms`	No
`output_resolution`	No	Output resolution. Declared type: string. Known values: "360p", "720p", "1080p", "4k".
`last_frame_image_url`	No	Public last-frame image URL; requires first_frame_image_url. Declared type: string.
`reference_image_urls`	No	Public reference image URLs; images, video clips, and characters share a seven-unit reference limit. Declared type: array.
`first_frame_image_url`	No	Public first-frame image URL; mutually exclusive with reference images, audio IDs, video clips, and character IDs. Declared type: string.

Schema Changelog

Changes observed during successful MCP inspections.

Changed31 schema fields changedv0.3.1Oct 26, 2026

addedInput schema / additionalProperties
```
Added value: +{}
```

removedInput schema / properties / aspect_ratio / anyOf

Removed value: -[
-  {
-    "const": "16:9",
-    "type": "string"
-  },
-  {
-    "const": "9:16",
-    "type": "string"
-  }
-]

changedInput schema / properties / aspect_ratio / description

Previous value: -"Output aspect ratio."New value: +"Output aspect ratio. Declared type: string. Known values: \"16:9\", \"9:16\"."

addedInput schema / properties / aspect_ratio / type
```
Added value: +"string"
```

changedInput schema / properties / audio_ids / description

Previous value: -"Audio preset IDs returned by create-audio."New value: +"Audio preset IDs returned by create-audio. Declared type: array."

changedInput schema / properties / callback_url / description

Previous value: -"Webhook URL for terminal Task delivery."New value: +"Webhook URL for terminal Task delivery. Declared type: string."

changedInput schema / properties / character_ids / description

Previous value: -"Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units."New value: +"Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units. Declared type: array."

changedInput schema / properties / duration_seconds / description

Previous value: -"Output duration in seconds."New value: +"Output duration in seconds. Declared type: integer."

changedInput schema / properties / duration_seconds / type
```
Previous value: -"number"New value: +"integer"
```

changedInput schema / properties / first_frame_image_url / description

Previous value: -"Public first-frame image URL; mutually exclusive with reference images, audio IDs, video clips, and character IDs."New value: +"Public first-frame image URL; mutually exclusive with reference images, audio IDs, video clips, and character IDs. Declared type: string."

removedInput schema / properties / first_frame_image_url / pattern
```
Removed value: -"^https?:\\/\\/"
```

changedInput schema / properties / last_frame_image_url / description

Previous value: -"Public last-frame image URL; requires first_frame_image_url."New value: +"Public last-frame image URL; requires first_frame_image_url. Declared type: string."

removedInput schema / properties / last_frame_image_url / pattern
```
Removed value: -"^https?:\\/\\/"
```

removedInput schema / properties / model / enum

Removed value: -[
-  "gemini-omni-flash-1-1",
-  "gemini-omni-flash-preview",
-  "gemini-omni-text-to-video"
-]

removedInput schema / properties / output_resolution / anyOf

Removed value: -[
-  {
-    "const": "360p",
-    "type": "string"
-  },
-  {
-    "const": "720p",
-    "type": "string"
-  },
-  {
-    "const": "1080p",
-    "type": "string"
-  },
-  {
-    "const": "4k",
-    "type": "string"
-  }
-]

changedInput schema / properties / output_resolution / description

Previous value: -"Output resolution."New value: +"Output resolution. Declared type: string. Known values: \"360p\", \"720p\", \"1080p\", \"4k\"."

addedInput schema / properties / output_resolution / type
```
Added value: +"string"
```

changedInput schema / properties / prompt / description

Previous value: -"Video generation prompt."New value: +"Video generation prompt. Declared type: string."

removedInput schema / properties / prompt / maxLength
```
Removed value: -20000
```

changedInput schema / properties / reference_image_urls / description

Previous value: -"Public reference image URLs; images, video clips, and characters share a seven-unit reference limit."New value: +"Public reference image URLs; images, video clips, and characters share a seven-unit reference limit. Declared type: array."

changedInput schema / properties / seed / description

Previous value: -"Deterministic generation seed."New value: +"Deterministic generation seed. Declared type: integer."

removedInput schema / properties / seed / maximum
```
Removed value: -2147483647
```
removedInput schema / properties / seed / minimum
```
Removed value: -0
```

changedInput schema / properties / seed / type

Previous value: -"number"New value: +"integer"

changedInput schema / properties / video_list / description

Previous value: -"Source video clips; each clip consumes two reference units."New value: +"Source video clips; each clip consumes two reference units. Declared type: array."

addedInput schema / properties / video_list / items / additionalProperties
```
Added value: +true
```

removedInput schema / properties / video_list / items / properties / ends / description

Removed value: -"Clip end time in seconds; must be greater than start and no more than 10 seconds after start."

removedInput schema / properties / video_list / items / properties / ends / minimum
```
Removed value: -0
```
removedInput schema / properties / video_list / items / properties / start / description
```
Removed value: -"Clip start time in seconds."
```
removedInput schema / properties / video_list / items / properties / start / minimum
```
Removed value: -0
```
removedInput schema / properties / video_list / items / properties / url / description
```
Removed value: -"Public source video URL."
```

Changed23 schema fields changedv0.2.2Sep 14, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

addedInput schema / properties / aspect_ratio / anyOf

Added value: +[
+  {
+    "const": "16:9",
+    "type": "string"
+  },
+  {
+    "const": "9:16",
+    "type": "string"
+  }
+]

removedInput schema / properties / aspect_ratio / enum
```
Removed value: -[
-  "16:9",
-  "9:16"
-]
```
removedInput schema / properties / aspect_ratio / type
```
Removed value: -"string"
```

addedInput schema / properties / audio_ids / description

Added value: +"Audio preset IDs returned by create-audio."

addedInput schema / properties / character_ids / description

Added value: +"Character IDs returned by create-character; dual-image characters consume two of the shared seven reference units."

addedInput schema / properties / duration_seconds / description
```
Added value: +"Output duration in seconds."
```

addedInput schema / properties / first_frame_image_url

Added value: +{
+  "description": "Public first-frame image URL; mutually exclusive with reference images, audio IDs, video clips, and character IDs.",
+  "pattern": "^https?:\\/\\/",
+  "type": "string"
+}

addedInput schema / properties / last_frame_image_url

Added value: +{
+  "description": "Public last-frame image URL; requires first_frame_image_url.",
+  "pattern": "^https?:\\/\\/",
+  "type": "string"
+}

changedInput schema / properties / model / enum

Previous value: -[
-  "gemini-omni-flash-preview",
-  "gemini-omni-text-to-video"
-]New value: +[
+  "gemini-omni-flash-1-1",
+  "gemini-omni-flash-preview",
+  "gemini-omni-text-to-video"
+]

addedInput schema / properties / output_resolution / anyOf

Added value: +[
+  {
+    "const": "360p",
+    "type": "string"
+  },
+  {
+    "const": "720p",
+    "type": "string"
+  },
+  {
+    "const": "1080p",
+    "type": "string"
+  },
+  {
+    "const": "4k",
+    "type": "string"
+  }
+]

removedInput schema / properties / output_resolution / enum
```
Removed value: -[
-  "720p",
-  "1080p",
-  "4k"
-]
```
removedInput schema / properties / output_resolution / type
```
Removed value: -"string"
```
addedInput schema / properties / poll_interval_ms / maximum
```
Added value: +9007199254740991
```

addedInput schema / properties / reference_image_urls / description

Added value: +"Public reference image URLs; images, video clips, and characters share a seven-unit reference limit."

addedInput schema / properties / seed / description
```
Added value: +"Deterministic generation seed."
```
addedInput schema / properties / seed / maximum
```
Added value: +2147483647
```
addedInput schema / properties / seed / minimum
```
Added value: +0
```
addedInput schema / properties / timeout_ms / maximum
```
Added value: +9007199254740991
```

addedInput schema / properties / video_list / description

Added value: +"Source video clips; each clip consumes two reference units."

addedInput schema / properties / video_list / items / properties

Added value: +{
+  "ends": {
+    "description": "Clip end time in seconds; must be greater than start and no more than 10 seconds after start.",
+    "minimum": 0,
+    "type": "number"
+  },
+  "start": {
+    "description": "Clip start time in seconds.",
+    "minimum": 0,
+    "type": "number"
+  },
+  "url": {
+    "description": "Public source video URL.",
+    "type": "string"
+  }
+}

addedInput schema / properties / video_list / items / required
```
Added value: +[
+  "url",
+  "ends",
+  "start"
+]
```
addedInput schema / properties / video_list / items / type
```
Added value: +"object"
```

Changed5 schema fields changedv0.2.1Aug 5, 2026
- addedInput schema / properties / aspect_ratio / description
```
Added value: +"Output aspect ratio."
```
- addedInput schema / properties / callback_url / description
```
Added value: +"Webhook URL for terminal Task delivery."
```
- addedInput schema / properties / output_resolution / description
```
Added value: +"Output resolution."
```
- addedInput schema / properties / prompt / description
```
Added value: +"Video generation prompt."
```
- addedInput schema / properties / prompt / maxLength
```
Added value: +20000
```

Changed11 schema fields changedv0.2.0Jul 22, 2026

addedInput schema / properties / audio_ids

Added value: +{
+  "items": {},
+  "type": "array"
+}

addedInput schema / properties / callback_url
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / character_ids

Added value: +{
+  "items": {},
+  "type": "array"
+}

removedInput schema / properties / duration_seconds / enum
```
Removed value: -[
-  4,
-  6,
-  8,
-  10
-]
```

changedInput schema / properties / model / enum

Previous value: -[
-  "gemini-omni-text-to-video"
-]New value: +[
+  "gemini-omni-flash-preview",
+  "gemini-omni-text-to-video"
+]

addedInput schema / properties / prompt / type
```
Added value: +"string"
```
addedInput schema / properties / reference_image_urls / items
```
Added value: +{}
```
addedInput schema / properties / reference_image_urls / type
```
Added value: +"array"
```
addedInput schema / properties / seed
```
Added value: +{
+  "type": "number"
+}
```

addedInput schema / properties / video_list

Added value: +{
+  "items": {},
+  "type": "array"
+}

changedInput schema / required

Previous value: -[
-  "duration_seconds"
-]New value: +[
+  "prompt"
+]

First observedv0.1.0Jun 24, 2026

TDQS

C2.9/5.0

Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the full disclosure burden. It helpfully names the return values (task id, status, output URLs), compensating for the missing output schema, but says nothing about the fact that this is a remote asynchronous, likely paid generation job, that wait defaults to true and can block for a long time, or how timeout_ms/poll_interval_ms interact with that blocking behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences, front-loaded with the action and followed by the return contract. There is essentially no waste, though the brevity leaves major behavioral questions unaddressed (a completeness problem rather than a verbosity one).

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter generative media tool with zero annotations and no output schema, the description is thin: it omits cost/credit implications, the default blocking behavior from wait=true, prerequisite creation tools, and the reference-unit budget's practical consequences. Only the return values are covered adequately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 88%, so the schema already explains most parameters including the seven-reference-unit budget, mutual exclusivity of first_frame_image_url, and enum-like value sets for aspect_ratio and output_resolution. The description adds nothing beyond that, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description gives a specific verb and resource ('Create a Gemini Omni task on RunAPI (text to video)') and states the return shape (task id, status, output URLs). It is clearly separable from siblings like get_task, create_audio, and create_character, though the 'text to video' label understates the schema's image/video/character reference inputs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to choose this tool versus alternatives, no prerequisite steps (e.g., create_character/create_audio must run first to obtain character_ids/audio_ids), and no mention of check_pricing before spending credits or get_task for non-blocking polling. The agent must infer call order entirely from parameter descriptions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server