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

# Create video

> Grok Imagine async video create.

**Path:** `POST https://api.omniall.ai/v1/videos`

Poll with returned `id` via `GET /v1/videos/{task_id}`.

Model ids from the [Model Square](https://omniall.ai/pricing). Common: `grok-imagine-video-1.5-preview`, `grok-imagine-video`; variants like `grok-video-1.5-pro` / `grok-video-1.5-max` may be available on your account.

Auth: `Authorization: Bearer sk-...`



## OpenAPI

````yaml openapi/grok-video.yaml POST /v1/videos
openapi: 3.1.0
info:
  title: Omniall AI — Grok video
  version: 1.0.0
  description: >-
    Grok Imagine async video create.


    **Path:** `POST https://api.omniall.ai/v1/videos`


    Poll with returned `id` via `GET /v1/videos/{task_id}`.


    Model ids from the [Model Square](https://omniall.ai/pricing). Common:
    `grok-imagine-video-1.5-preview`, `grok-imagine-video`; variants like
    `grok-video-1.5-pro` / `grok-video-1.5-max` may be available on your
    account.


    Auth: `Authorization: Bearer sk-...`
servers:
  - url: https://api.omniall.ai
security: []
paths:
  /v1/videos:
    post:
      tags:
        - Grok video
      summary: Create video
      description: >-
        Grok Imagine async video create.


        **Path:** `POST https://api.omniall.ai/v1/videos`


        Poll with returned `id` via `GET /v1/videos/{task_id}`.


        Model ids from the [Model Square](https://omniall.ai/pricing). Common:
        `grok-imagine-video-1.5-preview`, `grok-imagine-video`; variants like
        `grok-video-1.5-pro` / `grok-video-1.5-max` may be available on your
        account.


        Auth: `Authorization: Bearer sk-...`
      operationId: grokCreateVideo
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer sk-...
          description: Bearer API key, e.g. `Bearer sk-...`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
                - prompt
              description: Grok Imagine video create body (`POST /v1/videos`).
              properties:
                model:
                  type: string
                  description: >-
                    Video model id. Model ids from the [Model
                    Square](https://omniall.ai/pricing). Common:
                    `grok-imagine-video-1.5-preview`, `grok-imagine-video`;
                    variants like `grok-video-1.5-pro` / `grok-video-1.5-max`
                    may be available on your account.
                  example: grok-imagine-video-1.5-preview
                prompt:
                  type: string
                  description: Video prompt, up to ~4096 characters.
                  example: >-
                    Rainy neon street at night, a vintage sports car driving on
                    wet asphalt
                  maxLength: 4096
                seconds:
                  type: string
                  description: >-
                    Target duration in seconds as a string (e.g. `"6"`, `"8"`).
                    Minimum 1. Alias: integer `duration`.
                  example: '8'
                duration:
                  type: integer
                  description: Integer form of `seconds`.
                  minimum: 1
                aspect_ratio:
                  type: string
                  description: Aspect ratio presets or custom `number:number`.
                  enum:
                    - '1:1'
                    - '16:9'
                    - '9:16'
                    - '4:3'
                    - '3:4'
                    - '3:2'
                    - '2:3'
                    - '2:1'
                    - '1:2'
                    - 19.5:9
                    - '9:19.5'
                    - '20:9'
                    - '9:20'
                  example: '16:9'
                resolution:
                  type: string
                  description: >-
                    Output clarity: `480P` / `720P` (case-insensitive; `480` /
                    `720` also ok).
                  enum:
                    - 480P
                    - 720P
                    - '480'
                    - '720'
                    - 480p
                    - 720p
                  example: 720P
                image:
                  type: string
                  description: >-
                    Single reference image (Data URI preferred, or HTTPS URL).
                    **Do not use with `reference_images`.**
                reference_images:
                  type: array
                  items:
                    type: string
                  description: >-
                    Multiple reference images (Data URI or URL). **Do not use
                    with `image`.**
                images:
                  type: array
                  items:
                    type: string
                  description: Compatible array form for references.
            examples:
              text_to_video:
                summary: Text-to-video
                value:
                  model: grok-imagine-video-1.5-preview
                  prompt: >-
                    Rainy neon street at night, a vintage sports car driving on
                    wet asphalt
                  seconds: '8'
                  aspect_ratio: '16:9'
                  resolution: 720P
              image_to_video:
                summary: Single image-to-video
                value:
                  model: grok-imagine-video-1.5-preview
                  prompt: >-
                    Make the person turn their head and smile; slow camera
                    push-in
                  seconds: '6'
                  aspect_ratio: '9:16'
                  resolution: 720P
                  image: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...
              multi_image_reference:
                summary: Multi-image reference
                value:
                  model: grok-imagine-video-1.5-preview
                  prompt: >-
                    Match character look and scene mood from these images;
                    generate a continuous walking shot
                  seconds: '8'
                  aspect_ratio: '16:9'
                  resolution: 720P
                  reference_images:
                    - data:image/jpeg;base64,/9j/4AAQ...
                    - data:image/jpeg;base64,/9j/4AAQ...
      responses:
        '200':
          description: Task accepted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Task id.
                  object:
                    type: string
                    example: video
                  model:
                    type: string
                  status:
                    type: string
                    description: e.g. queued / in_progress / completed.
                  progress:
                    type: integer
                  created_at:
                    type: integer
                  seconds:
                    type: string
                  size:
                    type: string
              example:
                id: video_abc123
                object: video
                model: grok-imagine-video-1.5-preview
                status: queued
                progress: 0
                created_at: 1710000000
                seconds: '8'
        '400':
          description: Invalid request
        '401':
          description: Unauthorized

````

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