xAI

Grok Imagine API

Images and short clips from one endpoint

Returns a still or animates it into a short loop in the same request.

Text to imageImage to videoFast

Quickstart

Authenticate with a bearer token from your dashboard, then POST the request below.

curl -X POST https://api.viddly.io/v1/images/generations \
  -H "Authorization: Bearer $VIDDLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine",
    "prompt": "a lighthouse in a storm, drone orbit, dusk",
    "size": "1024x1024",
    "num_images": 1
  }'

Parameters

Name	Type	Default	Description
prompt*	text	—	What to generate. Describe subject, action, camera and lighting.
image_url	image	—	Optional reference or first-frame image. Publicly reachable URL.
size	enum1024x1024 \| 1536x1024 \| 2048x2048	1024x1024	Output dimensions.
num_images	number	1	How many images to return (1–4).
seed	number	—	Fix for reproducible results.