Skip to main content
POST
Grok Imagine 1.5

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be grok_imagine_1_5.

Available options:
grok_imagine_1_5
prompt
string
required

Text prompt describing the video. Max 4096 characters.

Maximum string length: 4096
image_url
string<uri>

Optional reference image URL. Omit it for pure text-to-video. Max 20MB; jpeg/png/webp. This endpoint takes a single image — for 2-7 reference images use grok_imagine_1_5_refs. (The legacy image_urls array is still accepted and still limited to one item.)

duration
integer
default:8

Video duration in seconds (1-15). Default 8.

Required range: 1 <= x <= 15
resolution
enum<string>
default:480p

Output resolution. 1080p takes longer to finish.

Available options:
480p,
720p,
1080p
ratio
enum<string>
default:auto

Aspect ratio. Effective for text-to-video; when a reference image is supplied the video follows the image's dimensions.

Available options:
auto,
1:1,
16:9,
9:16,
3:2,
2:3
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required