> ## 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. # Hailuo 02 T2V > [Core Function] Hailuo 02 T2V is a text-to-video generation model optimized for physical realism. [Strengths] It excels at complex physics simulation, fluid dynamics, broad cinematic scenes, and natively rendering 1080p video up to 10 seconds without downscaling. [Best For] Highly recommended for: product commercials, high-speed sports action, nature documentaries, and sweeping landscapes. [Limitations] Do NOT use this model for highly stylized anime/art or nuanced human micro-expressions, where Hailuo 2.3 performs better. [Routing] Route to this model when the user requests '1080p for 10 seconds', complex physical action (like splashing water or crashes), or broad landscapes. For human characters and stylization, use Hailuo 2.3 T2V. ## OpenAPI ````yaml /model-api/minimax/minimax-t2v.json post /minimax/hailuo-02-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/hailuo-02-t2v: post: summary: Hailuo 02 T2V description: >- [Core Function] Hailuo 02 T2V is a text-to-video generation model optimized for physical realism. [Strengths] It excels at complex physics simulation, fluid dynamics, broad cinematic scenes, and natively rendering 1080p video up to 10 seconds without downscaling. [Best For] Highly recommended for: product commercials, high-speed sports action, nature documentaries, and sweeping landscapes. [Limitations] Do NOT use this model for highly stylized anime/art or nuanced human micro-expressions, where Hailuo 2.3 performs better. [Routing] Route to this model when the user requests '1080p for 10 seconds', complex physical action (like splashing water or crashes), or broad landscapes. For human characters and stylization, use Hailuo 2.3 T2V. operationId: minimaxHailuo02T2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/MinimaxHailuo02T2VRequest' examples: basic: summary: Basic video generation value: prompt: A peaceful beach at sunset with gentle waves with_optimization: summary: With prompt optimization value: prompt: Aerial view of a forest in autumn, camera slowly descending prompt_optimizer: true fast_pretreatment: false duration: 10 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: MinimaxHailuo02T2VRequest: type: object required: - prompt properties: prompt: type: string description: Video content description, supports Chinese and English minLength: 1 maxLength: 2000 example: A peaceful beach at sunset with gentle waves prompt_optimizer: type: boolean description: Enable automatic prompt optimization default: true example: true fast_pretreatment: type: boolean description: Fast pretreatment mode (only effective when prompt_optimizer=true) default: false example: false duration: type: integer description: Video duration in seconds default: 6 enum: - 6 - 10 example: 6 resolution: type: string description: Video resolution default: 768P enum: - 768P - 1080P example: 768P 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`.' ````