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

# Grok Imagine Video 1.5

> Text, image, and reference-to-video generation with Grok Imagine Video 1.5

# Grok Imagine Video 1.5

Create 1–15 second videos from text, a single first-frame image, or up to seven reference images.

<Info>
  After submission, use the returned `task_id` with the video status endpoint, or provide `callback_url` to receive the completed result.
</Info>

## Generation modes

* **Text to video:** omit both image fields. Supports `480p`, `720p`, and `1080p`.
* **Image to video:** provide exactly one URL in `image_urls`. Supports `480p`, `720p`, and `1080p`.
* **Reference to video:** provide 1–7 URLs in `reference_image_urls` and refer to them as `<IMAGE_0>`, `<IMAGE_1>`, and so on. Supports `480p` and `720p`.

`image_urls` and `reference_image_urls` cannot be used together. `aspect_ratio` is available for text and reference modes, but not first-frame image-to-video.

## Parameters

* `prompt` (required): up to 4,096 characters.
* `resolution`: `480p`, `720p`, or `1080p`. Default: `720p`.
* `duration`: integer from `1` to `15`. Default: `6` for text/image mode and `8` for reference mode.
* `aspect_ratio`: `16:9`, `4:3`, `3:2`, `1:1`, `2:3`, `3:4`, or `9:16`. Default: `16:9` where supported.
* `callback_url`: optional HTTPS completion webhook.

## Billing

Video output is billed per second by resolution: 14.5 credits at 480p, 25 credits at 720p, and 45 credits at 1080p. Each submitted input or reference image adds 2 credits.

<Tip>
  Use public HTTPS image URLs or upload images through the playground before submitting.
</Tip>


## OpenAPI

````yaml api-manual/video-series/grok-imagine-video-1-5.json POST /api/generate/submit
openapi: 3.1.0
info:
  title: Vidgo API - Grok Imagine Video 1.5 API
  description: Text, image, and reference-to-video generation with Grok Imagine Video 1.5
  version: 1.0.0
servers:
  - url: https://api.vidgo.ai
security: []
paths:
  /api/generate/submit:
    post:
      tags:
        - Grok Imagine Video 1.5
      summary: Submit Grok Imagine Video 1.5 task
      operationId: submitGrokImagineVideo15Task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitRequest'
            examples:
              text-to-video:
                summary: Text to video
                value:
                  model: grok-imagine-video-1.5
                  input:
                    prompt: A cinematic city at sunrise
                    resolution: 1080p
                    duration: 6
                    aspect_ratio: '16:9'
              image-to-video:
                summary: First-frame image to video
                value:
                  model: grok-imagine-video-1.5
                  input:
                    prompt: The camera slowly pushes forward
                    image_urls:
                      - https://example.com/first-frame.webp
                    resolution: 720p
                    duration: 6
              reference-to-video:
                summary: Reference images to video
                value:
                  model: grok-imagine-video-1.5
                  input:
                    prompt: <IMAGE_0> walks through the setting in <IMAGE_1>
                    reference_image_urls:
                      - https://example.com/character.webp
                      - https://example.com/location.webp
                    resolution: 720p
                    duration: 8
                    aspect_ratio: '16:9'
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    SubmitRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          enum:
            - grok-imagine-video-1.5
        input:
          $ref: '#/components/schemas/VideoInput'
        callback_url:
          type: string
          format: uri
    SubmitResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type: string
              format: date-time
    VideoInput:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          maxLength: 4096
        image_urls:
          type: array
          minItems: 1
          maxItems: 1
          items:
            type: string
            format: uri
        reference_image_urls:
          type: array
          minItems: 1
          maxItems: 7
          items:
            type: string
            format: uri
        resolution:
          type: string
          enum:
            - 480p
            - 720p
            - 1080p
          default: 720p
        duration:
          type: integer
          minimum: 1
          maximum: 15
        aspect_ratio:
          type: string
          enum:
            - '16:9'
            - '4:3'
            - '3:2'
            - '1:1'
            - '2:3'
            - '3:4'
            - '9:16'
      description: >-
        Omit image fields for text-to-video. image_urls and reference_image_urls
        are mutually exclusive. Reference mode does not support 1080p;
        first-frame image mode does not support aspect_ratio.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````