> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Imagine 1.5 Lite Video

> - Grok Imagine 1.5 Lite (grok-imagine-video-1.5-lite) is the lower-priced tier of Grok Imagine 1.5: text-to-video and image-to-video under one model name
- There is no mode parameter: the number of entries in `image_urls` selects the mode — `0` = text-to-video, `1` = image-to-video (used as the first frame). Reference images (2 or more) are not supported
- `1080p` output is upscaled from 720p and billed at a higher per-second rate
- Asynchronous processing mode, use the returned task ID to [query](/en/api-manual/task-management/get-task-detail)
- Generated video links are valid for 24 hours, please save them promptly



## OpenAPI

````yaml en/api-manual/video-series/grok/grok-imagine-video-1.5-lite.json POST /v1/videos/generations
openapi: 3.1.0
info:
  title: grok-imagine-video-1.5-lite Interface
  description: >-
    Use Grok Imagine 1.5 Lite for lower-priced text-to-video and image-to-video
    generation
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Production environment
security:
  - bearerAuth: []
paths:
  /v1/videos/generations:
    post:
      tags:
        - Video Generation
      summary: grok-imagine-video-1.5-lite Interface
      description: >-
        - Grok Imagine 1.5 Lite (grok-imagine-video-1.5-lite) is the
        lower-priced tier of Grok Imagine 1.5: text-to-video and image-to-video
        under one model name

        - There is no mode parameter: the number of entries in `image_urls`
        selects the mode — `0` = text-to-video, `1` = image-to-video (used as
        the first frame). Reference images (2 or more) are not supported

        - `1080p` output is upscaled from 720p and billed at a higher per-second
        rate

        - Asynchronous processing mode, use the returned task ID to
        [query](/en/api-manual/task-management/get-task-detail)

        - Generated video links are valid for 24 hours, please save them
        promptly
      operationId: createGrokImagineVideo15LiteGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GrokImagineVideo15LiteRequest'
            examples:
              text_to_video:
                summary: Text to Video (no image)
                value:
                  model: grok-imagine-video-1.5-lite
                  prompt: >-
                    A neon-lit street at night, slow dolly forward through the
                    rain
                  duration: 6
                  quality: 480p
                  aspect_ratio: '16:9'
              image_to_video:
                summary: Image to Video (1 image)
                value:
                  model: grok-imagine-video-1.5-lite
                  prompt: The person starts dancing
                  image_urls:
                    - >-
                      https://cdn.evolink.ai/Model-Example/GrokImagine1.5/generated-image.png
                  duration: 6
                  quality: 480p
      responses:
        '200':
          description: Video task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VideoGenerationResponse'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: invalid_request
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Unauthenticated, invalid or expired token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: unauthorized
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Insufficient quota, recharge required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: insufficient_quota
                  message: Insufficient quota. Please top up your account.
                  type: insufficient_quota
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: >-
                    Token does not have access to model:
                    grok-imagine-video-1.5-lite
                  type: invalid_request_error
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Too many requests, please try again later
                  type: rate_limit_error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: Internal server error
                  type: api_error
components:
  schemas:
    GrokImagineVideo15LiteRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: Model name
          enum:
            - grok-imagine-video-1.5-lite
          default: grok-imagine-video-1.5-lite
          example: grok-imagine-video-1.5-lite
        prompt:
          type: string
          description: >-
            Video description prompt (required, cannot be empty)


            **EvoLink platform length limit:** Up to `2000` tokens (counted with
            the cl100k tokenizer, so CJK prompts hit the cap at far fewer
            characters than Latin ones). The platform also enforces a limit of
            60000 UTF-8 bytes.
          example: The person starts dancing
        image_urls:
          type: array
          items:
            type: string
            format: uri
          description: >-
            Input image URL (optional). One image switches the request to
            image-to-video.


            **Mode selection:**

            - `0` images (omit the field): text-to-video, no image charge

            - `1` image: image-to-video, used as the first frame; input images
            are billed separately (see the [pricing
            section](https://evolink.ai/grok-imagine-video-1-5-lite#pricing))

            - `2` or more images are rejected — reference-to-video is not
            supported on Lite


            **Requirements:**

            - Playground local uploads: up to `10MiB` (10485760 bytes) per
            image. Image URLs sent directly to the API are validated upstream
            and do not use this local upload check.

            - Supported formats: JPEG, PNG, WebP
          minItems: 0
          maxItems: 1
          example:
            - https://example.com/image.jpg
        duration:
          type: integer
          description: Video duration (seconds), any integer between `1` and `15` seconds
          minimum: 1
          maximum: 15
          default: 6
          example: 6
        quality:
          type: string
          description: >-
            Video resolution, default is `480p`


            **Description:**

            - `480p`: Standard definition (default)

            - `720p`: High definition

            - `1080p`: Upscaled from 720p, billed at a higher per-second rate


            See the [pricing
            section](https://evolink.ai/grok-imagine-video-1-5-lite#pricing) for
            the per-resolution rates.
          enum:
            - 480p
            - 720p
            - 1080p
          default: 480p
          example: 480p
        aspect_ratio:
          type: string
          description: >-
            Output aspect ratio, default is `auto`


            **Applies to:** text-to-video (`0` images). With an input image the
            output follows that image's dimensions and this parameter is
            ignored.


            **Description:**

            - `auto`: No ratio is sent upstream and the upstream channel decides
            the framing (text-to-video currently renders 16:9); this is the
            default value

            - `16:9`: Landscape

            - `9:16`: Portrait

            - `1:1`: Square

            - `4:3`: Landscape, classic TV ratio

            - `3:4`: Portrait, classic TV ratio

            - `3:2`: Landscape, classic photo ratio

            - `2:3`: Portrait, classic photo ratio
          enum:
            - auto
            - '16:9'
            - '9:16'
            - '1:1'
            - '4:3'
            - '3:4'
            - '3:2'
            - '2:3'
          default: auto
          example: '16:9'
        callback_url:
          type: string
          description: >-
            HTTPS callback URL after task completion


            **Callback Timing:**

            - Triggered when task is completed, failed, or cancelled


            **Security Restrictions:**

            - Only HTTPS protocol supported

            - Callback to internal IPs prohibited (127.0.0.1, 10.x.x.x,
            172.16-31.x.x, 192.168.x.x, etc.)

            - URL length must not exceed `2048` UTF-8 bytes


            **Callback Mechanism:**

            - Timeout: `10` seconds

            - Max `3` retries on failure (after `1`/`2`/`4` seconds)

            - The callback request body uses the task query API response
            structure

            - 2xx status code = success, others trigger retry
          format: uri
          example: https://your-domain.com/webhooks/video-task-completed
    VideoGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Task creation timestamp
          example: 1757169743
        id:
          type: string
          description: Task ID
          example: task-unified-1757169743-7cvnl5zw
        model:
          type: string
          description: Actual model name used
          example: grok-imagine-video-1.5-lite
        object:
          type: string
          enum:
            - video.generation.task
          description: Specific task type
        progress:
          type: integer
          description: Task progress percentage (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Task status
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/VideoTaskInfo'
          description: Video task detailed information
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Task output type
          example: video
        usage:
          $ref: '#/components/schemas/Usage'
          description: Usage and billing information
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code identifier
            message:
              type: string
              description: Error description
            type:
              type: string
              description: Error type
    VideoTaskInfo:
      type: object
      properties:
        can_cancel:
          type: boolean
          description: Whether the task can be cancelled
          example: false
        estimated_time:
          type: integer
          description: Estimated completion time (seconds)
          minimum: 0
          example: 120
        video_duration:
          type: integer
          description: Video duration (seconds)
          example: 6
    Usage:
      type: object
      description: Usage and billing information
      properties:
        billing_rule:
          type: string
          description: Billing rule
          enum:
            - per_call
            - per_token
            - per_second
          example: per_second
        credits_reserved:
          type: number
          description: Estimated credits consumed
          minimum: 0
          example: 5.712
        user_group:
          type: string
          description: User group category
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##All APIs require Bearer Token authentication##


        **Get API Key:**


        Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to
        get your API Key


        **Add to request header:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.