Skip to main content
← Grok Imagine Video 1.5 Endpoint: POST https://api.higgsfield.ai/xai/grok-imagine-video/v1.5/reference-to-video Endpoint ID: xai/grok-imagine-video/v1.5/reference-to-video ▶Open API PlaygroundGrok Imagine Video 1.5 · Reference to video↗

Usage notes

  • This endpoint also accepts text-only requests or one first-frame image. Choose either image_url or reference media (image_urls/audio_url); do not combine these modes.
  • When image_urls or audio_url is provided, resolution must be 480p or 720p. The shared schema also lists 1080p, which is rejected in reference mode.
  • Input images must decode as JPEG, PNG, WebP or GIF; SVG and XML are unsupported.

Quick start

Replace the example media URLs with publicly accessible URLs for your own files before submitting.

Input schema

string
required
Write your prompt here
integer
default:"5"
Requested output duration in seconds. Minimum: 1. Maximum: 15.
string
Public URL of the audio reference. Format: uri.
string
Public URL of the input image. Format: uri.
array
Ordered public image reference URLs. Minimum items: 0. Maximum items: 7. Each item: string. Format: uri.
string
default:"480p"
Output resolution tier. Allowed values: "480p", "720p", "1080p".
string
default:"auto"
Output width-to-height ratio. Allowed values: "auto", "1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3".

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.
Accepted
A completed response includes the following output fields:
See polling, request errors and authentication for shared request handling.