XAI (Grok)

Image and video generation on https://api.mountsea.ai — async taskId, then poll GET /xai/tasks.

Models

Image

Model	Notes
`grok-imagine-image`	Default Imagine image
`grok-imagine-image-quality`	Higher-quality Imagine image
`grok-imagine-image-2.0`	Imagine 2.0 — supports `quality` (`low` / `medium` / `auto`) and `resolution` `1k` / `2k`

Video

Model	Notes
`grok-imagine-video`	Imagine video — max resolution 720P
`grok-imagine-video-1.5`	Imagine video 1.5 — supports 1080P

Features

Text-to-Image

Prompt + model. Optional n (1–10), aspectRatio, resolution.

Image-to-Image

Up to 5 reference URLs. Omit aspectRatio to follow the first image.

Text-to-Video

Duration 6–20s, aspect ratio, 480P / 720P / 1080P (1.5 only).

Image-to-Video

Up to 5 reference URLs. Size follows the image — aspectRatio and resolution are ignored.

How a call works

Create a task

POST /xai/images or POST /xai/videos returns { "taskId": "..." }.

Poll until completed

Get Task Result — GET /xai/tasks?taskId=xxx.

curl -X POST "https://api.mountsea.ai/xai/images" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a cute cat sitting on a windowsill",
    "model": "grok-imagine-image-2.0",
    "n": 2,
    "aspectRatio": "16:9",
    "resolution": "2k",
    "quality": "medium"
  }'

curl -X POST "https://api.mountsea.ai/xai/videos" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a kitten eating fish",
    "model": "grok-imagine-video-1.5",
    "duration": 10,
    "aspectRatio": "16:9",
    "resolution": "1080P"
  }'

curl -X GET "https://api.mountsea.ai/xai/tasks?taskId=your-task-id" \
  -H "Authorization: Bearer your-api-key"

Endpoints

Endpoint	Method	Description
`/xai/images`	POST	Generate or edit images
`/xai/videos`	POST	Generate videos
`/xai/tasks`	GET	Poll by `taskId`

Image parameters

Parameter	Required	Description
`prompt`	Yes	Image description, max 5000 characters
`model`	Yes	`grok-imagine-image` / `grok-imagine-image-quality` / `grok-imagine-image-2.0`
`n`	No	Count 1–10, default `1`
`aspectRatio`	No	See table below. Omit for official `auto` (or follow first reference image)
`resolution`	No	`1k` / `2k`. Omit for official default `1k`
`quality`	No	`low` / `medium` / `auto` — only `grok-imagine-image-2.0`
`images`	No	Reference URLs, max 5. Without `aspectRatio`, output follows the first image

Image aspect ratios

2:3 3:2 1:1 9:16 16:9 4:3 3:4 2:1 1:2 19.5:9 9:19.5 20:9 9:20 21:9 5:2 auto

Video parameters

Parameter	Required	Description
`prompt`	Yes	Video description, max 1000 characters
`model`	Yes	`grok-imagine-video` / `grok-imagine-video-1.5`
`duration`	No	`6` (default), `10`, `12`, `15`, `20` seconds
`aspectRatio`	No	`2:3` `3:2` `1:1` `9:16` `16:9`
`resolution`	No	`480P` / `720P` (default) / `1080P`
`images`	No	Reference URLs, max 5. When set, `aspectRatio` and `resolution` are ignored

1080P is only valid on grok-imagine-video-1.5. grok-imagine-video maxes out at 720P.

Task status

Status	Description
`pending`	Queued
`ready`	Ready to run
`assigned`	Assigned to a worker
`processing`	Running
`completed`	Success — read `result`
`failed`	Error — see `errorMessage` / `errorCode`
`cancelled`	Cancelled
`timeout`	Timed out

result is the upstream payload (shape depends on image vs video).

API

Introduction

XAI (Grok)

Models

Image

Video

Features

Text-to-Image

Image-to-Image

Text-to-Video

Image-to-Video

How a call works

Endpoints

Image parameters

Image aspect ratios

Video parameters

Task status

​XAI (Grok)

​Models

​Image

​Video

​Features

Text-to-Image

Image-to-Image

Text-to-Video

Image-to-Video

​How a call works

​Endpoints

​Image parameters

​Image aspect ratios

​Video parameters

​Task status

XAI (Grok)

Models

Image

Video

Features

How a call works

Endpoints

Image parameters

Image aspect ratios

Video parameters

Task status