> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # MiniMax H3 Max T2V > [Core Function] MiniMax H3 Max T2V creates video from a text prompt only. [Strengths] It supports 5-15 second clips, 480P or 768P output, concrete aspect ratios from cinematic ultrawide to vertical, and optional prompt_expansion_mode (disabled, balanced, or quality). [Best For] Highly recommended for: prompt-only storyboards, character-driven shorts, cinematic B-roll from text, and drafts without image inputs. [Limitations] Do NOT use this model if you need to condition on images, first or last frames, or reference videos, or if you need 2K or a 4 second clip. prompt, duration, resolution, and ratio are required; ratio must be one of the documented aspect ratios. [Routing] Choose MiniMax H3 Max T2V for text-only MiniMax H3 Max video. If the user provides a start or end frame, use MiniMax H3 Max FL2V. If they provide reference images, use MiniMax H3 Max I2V. If they provide reference videos, use MiniMax H3 Max V2V. For 2K or 4 second clips, use MiniMax H3 T2V. ## OpenAPI ````yaml /media-model-api/minimax/minimax-t2v.json post /minimax/minimax-h3-max-t2v openapi: 3.1.0 info: description: The text-to-video models API from MiniMax. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: MiniMax Text-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The text-to-video models API from MiniMax. security: - bearerAuth: [] paths: /minimax/minimax-h3-max-t2v: post: summary: MiniMax H3 Max T2V description: >- [Core Function] MiniMax H3 Max T2V creates video from a text prompt only. [Strengths] It supports 5-15 second clips, 480P or 768P output, concrete aspect ratios from cinematic ultrawide to vertical, and optional prompt_expansion_mode (disabled, balanced, or quality). [Best For] Highly recommended for: prompt-only storyboards, character-driven shorts, cinematic B-roll from text, and drafts without image inputs. [Limitations] Do NOT use this model if you need to condition on images, first or last frames, or reference videos, or if you need 2K or a 4 second clip. prompt, duration, resolution, and ratio are required; ratio must be one of the documented aspect ratios. [Routing] Choose MiniMax H3 Max T2V for text-only MiniMax H3 Max video. If the user provides a start or end frame, use MiniMax H3 Max FL2V. If they provide reference images, use MiniMax H3 Max I2V. If they provide reference videos, use MiniMax H3 Max V2V. For 2K or 4 second clips, use MiniMax H3 T2V. operationId: minimaxH3MaxT2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MinimaxH3MaxT2VRequest' examples: basic: summary: Basic H3 Max T2V value: prompt: A boy playing basketball by the sea ratio: '16:9' duration: 5 resolution: 768P responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: MinimaxH3MaxT2VRequest: type: object required: - prompt - duration - resolution - ratio properties: prompt: type: string minLength: 1 maxLength: 7000 description: Video content description. duration: type: integer enum: - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 default: 5 description: Required video duration in seconds. 4 seconds is not supported. resolution: type: string enum: - 480P - 768P default: 768P description: Required output resolution. 2K is not supported. ratio: type: string enum: - '21:9' - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: '16:9' description: Required video aspect ratio. One of the listed values. prompt_expansion_mode: type: string enum: - disabled - balanced - quality default: balanced description: >- Optional prompt expansion. disabled turns expansion off; balanced is the default; quality prioritizes expansion quality. AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: 'Error message in format ''Category: detail''' example: 'Invalid parameters: parameter ''prompt'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_prompt: summary: Missing required prompt value: code: 400 message: 'Invalid parameters: parameter ''prompt'' is required' invalid_duration: summary: Invalid duration value value: code: 400 message: 'Invalid parameters: duration must be one of [6, 10]' invalid_resolution: summary: Invalid resolution for duration value: code: 400 message: >- Invalid parameters: 10 seconds duration only supports 768P resolution Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.