sora_list_models
List available Sora models with their capabilities, limits, and recommended use cases to select the right model for video generation.
Instructions
List all available Sora models and their capabilities.
Shows all available model versions with their limits, features, and
recommended use cases. Use this to understand which model to choose
for your video generation.
Returns:
Table of all models with their version, limits, and features.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- tools/info_tools.py:7-66 (handler)The actual handler function for the sora_list_models tool. Decorated with @mcp.tool() and returns a hardcoded table string of available Sora models with their capabilities.
async def sora_list_models() -> str: """List all available Sora models and their capabilities. Shows all available model versions with their limits, features, and recommended use cases. Use this to understand which model to choose for your video generation. Returns: Table of all models with their version, limits, and features. """ # Last updated: 2026-04-05 return """Available Sora Models: | Model | Max Duration (v1) | Max Duration (v2) | Quality | Features | |--------------|--------------------|--------------------|---------|-----------------------------------| | sora-2 | 15 seconds | 12 seconds | Good | Standard generation, cost-effective | | sora-2-pro | 25 seconds | 12 seconds | Best | Longer videos, higher quality | === Version 1 Options === Video Size: | Size | Description | |--------|--------------------------------| | small | Standard definition | | large | HD (only sora-2-pro for 25s) | Video Orientation: | Orientation | Aspect Ratio | Use Case | |-------------|--------------|-----------------------------| | landscape | 16:9 | YouTube, presentations | | portrait | 9:16 | TikTok, Instagram Stories | Duration: | Duration | Models | |----------|---------------------------| | 10s | sora-2, sora-2-pro | | 15s | sora-2, sora-2-pro | | 25s | sora-2-pro only | === Version 2 Options === Video Resolution: | Resolution | Orientation | Description | |------------|-------------|--------------------------| | 720x1280 | Vertical | HD vertical (default) | | 1280x720 | Horizontal | HD horizontal | | 1024x1792 | Vertical | Tall vertical | | 1792x1024 | Horizontal | Wide horizontal | Duration (seconds): | Seconds | Models | |---------|---------------------------| | 4s | sora-2, sora-2-pro | | 8s | sora-2, sora-2-pro | | 12s | sora-2, sora-2-pro | Recommendations: - Version 1: Use 'sora-2' with 'large' size for most use cases. Use 'sora-2-pro' for 25s videos. - Version 2: Use for precise resolution control and shorter videos (4-12s). Supports image reference via input_reference. """ - tools/info_tools.py:3-5 (registration)The mcp server instance is imported from core.server, and the @mcp.tool() decorator on the handler registers it as an MCP tool.
from core.server import mcp - tools/__init__.py:4-10 (registration)Imports info_tools module to trigger registration of all info tools (including sora_list_models) with the MCP server.
from tools import info_tools, task_tools, video_tools __all__ = [ "video_tools", "task_tools", "info_tools", ] - main.py:132-133 (registration)Startup banner listing sora_list_models as an available tool.
safe_print(" - sora_list_models") safe_print(" - sora_list_actions") - main.py:189-189 (registration)Server card registration listing sora_list_models in the HTTP endpoint's tool manifest.
{"name": "sora_list_models", "description": "List available models"},