X AI Grok Imagine Video V1.5 Image To Video API Documentation

X AI Grok Imagine Video V1.5 Image To Video API Documentation

Playground

xAI Grok Imagine Video v1.5 Image-to-Video turns a single input image and a natural-language prompt into short, stylized AI videos, with 480P, 720P, and 1080P output options and selectable aspect ratios for character animation, product videos, social media content, creative storytelling, and marketing workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

xAI Grok Imagine Video V1.5 Image-to-Video generates short videos with synchronized audio from a reference image and a natural-language prompt. It is designed for image-driven motion generation, cinematic concept clips, stylized social media content, and other prompt-based video creation workflows.

Why Choose This?

• Image-guided video generation Start from a single reference image and animate it into a short video clip.

• Prompt-based motion control Use text instructions to describe motion, camera behavior, atmosphere, and scene evolution.

• Simple resolution choices Choose 480p, 720p, or 1080p depending on your quality and budget needs.

• Predictable short-form generation Works well for short clips that need quick iteration and clean prompt-to-video control.

• Production-ready API Suitable for concept visualization, creator content, ads, and lightweight motion storytelling.

Parameters

How to Use

1. Upload your image — provide the source image you want to animate.
2. Write your prompt — describe the motion, scene, and camera behavior you want.
3. Set duration (optional) — choose an integer from 1 to 15 seconds. The default is 6.
4. Choose resolution — use 480p for lower cost, 720p for balance, or 1080p for higher-resolution output.
5. Submit — run the model and download the generated video.

Example Prompt

A cinematic push-in shot as the subject slowly turns toward the camera, soft natural motion, subtle background movement, realistic lighting, polished commercial style

Pricing

Pricing depends on the requested duration and resolution, plus a fixed $0.01 input image charge per request.

All example totals include the fixed $0.01 input image charge.

Example Costs

Best Use Cases

• Image-to-video animation — Turn a still image into a short motion clip.
• Social media content — Create lightweight animated visuals for posts and promos.
• Concept visualization — Explore motion directions from a static frame.
• Advertising mockups — Turn still campaign art into short animated demos.
• Creative prototyping — Quickly test prompt-driven motion ideas.

Pro Tips

• Use a clear, high-quality source image for better motion stability.
• Be specific in your prompt about camera movement, subject motion, and atmosphere.
• Start with shorter durations for fast iteration.
• Use 480p for quick testing and 720p/1080p for final-quality clips.
• Keep prompts focused on motion and scene evolution rather than repeating static visual details already present in the image.

Notes

• prompt and image are required; all other parameters are optional.
• duration accepts whole seconds from 1 to 15 and defaults to 6.
• resolution supports 480p, 720p, and 1080p, and defaults to 720p.
• Audio generation is enabled by default.
• Pricing depends on the requested duration, resolution, and the fixed $0.01 input image charge per request.

Related Models

• xAI Grok Imagine Video v1.5 Text-to-Video — Generate videos directly from text without an input image.
• xAI Grok Imagine Video v1.5 Reference-to-Video — Guide generation with up to seven reference images.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
  "duration": 6,
  "resolution": "720p"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/x-ai/grok-imagine-video-v1.5/image-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters