> ## 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. # Grok Imagine Video (Image-to-Video) > [Core Function] Grok Imagine Video I2V animates a single starting image into a video. [Strengths] It excels at producing smooth motion from one starting frame, guided by a text prompt for the desired movement. [Best For] Highly recommended for: bringing a photo or illustration to life, dynamic product showcases, and quick cinematic motion from a still. [Limitations] Do NOT use this model for text-only generation, for resolutions above 720p, or for clips longer than 15 seconds; it requires a starting image and is limited to 480p/720p and 15s. [Routing] Use this model when the user provides exactly one starting image. For reference-driven character video, use Reference-to-Video; for text-only video, use Text-to-Video. ## OpenAPI ````yaml /model-api/xai/xai-i2v.json post /xai/grok-imagine-video-i2v openapi: 3.1.0 info: description: >- The image-to-video models API from xAI Grok Imagine. Includes single-frame image-to-video (animate a starting image) and reference-to-video (generate a video that preserves the subjects from reference images). Tasks are asynchronous: submit, then poll the task endpoint for the result. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: xAI Grok Imagine Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from xAI Grok Imagine. security: - bearerAuth: [] paths: /xai/grok-imagine-video-i2v: post: summary: Grok Imagine Video (Image-to-Video) description: >- [Core Function] Grok Imagine Video I2V animates a single starting image into a video. [Strengths] It excels at producing smooth motion from one starting frame, guided by a text prompt for the desired movement. [Best For] Highly recommended for: bringing a photo or illustration to life, dynamic product showcases, and quick cinematic motion from a still. [Limitations] Do NOT use this model for text-only generation, for resolutions above 720p, or for clips longer than 15 seconds; it requires a starting image and is limited to 480p/720p and 15s. [Routing] Use this model when the user provides exactly one starting image. For reference-driven character video, use Reference-to-Video; for text-only video, use Text-to-Video. operationId: grokImagineVideoI2VAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/GrokImagineI2VRequest' examples: basic: summary: Image and prompt value: image: https://example.com/portrait.png prompt: The subject slowly turns toward the camera and smiles full_options: summary: Full options value: image: https://example.com/landscape.png prompt: Camera slowly pans right as clouds drift overhead duration: 8 aspect_ratio: '16:9' resolution: 720p responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-xai-i2v-001 model_id: xai/grok-imagine-video-i2v get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-xai-i2v-001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: GrokImagineI2VRequest: type: object required: - image - prompt description: >- xAI Grok Imagine image-to-video request (standard grok-imagine-video backbone). Animates a single starting frame. Resolution limited to 480p/720p. properties: prompt: type: string minLength: 1 description: Motion description for the generated video example: The subject slowly turns toward the camera and smiles image: type: string minLength: 1 description: Starting frame image URL or base64 data URI example: https://example.com/portrait.png duration: type: integer minimum: 1 maximum: 15 default: 8 description: Video duration in seconds example: 8 aspect_ratio: type: string enum: - '1:1' - '16:9' - '9:16' - '4:3' - '3:4' - '3:2' - '2:3' description: Video aspect ratio example: '16:9' resolution: type: string enum: - 480p - 720p default: 480p description: Video resolution example: 720p 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 for polling example: task-abc123 model_id: type: string description: Model ID in `provider/model` format example: xai/grok-imagine-video-i2v get_result: type: object description: API information to query the task result properties: method: type: string example: GET url: type: string 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 example: 400 message: type: string example: 'Invalid parameters: parameter ''image'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''image'' is required' 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`.' ````