grok-imagine-video-1.5-official

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5-official",
    "prompt": "Gentle cinematic push-in, golden-hour light, subtle motion",
    "image_urls": ["https://your-cdn.com/source.jpg"],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 8
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "grok-imagine-video-1.5-official",
        "prompt": "Gentle cinematic push-in, golden-hour light, subtle motion",
        "image_urls": ["https://your-cdn.com/source.jpg"],
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "duration": 8,
    },
    timeout=30,
)
print(resp.json())

const r = await fetch("https://reapi.ai/api/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-video-1.5-official",
    prompt: "Gentle cinematic push-in, golden-hour light, subtle motion",
    image_urls: ["https://your-cdn.com/source.jpg"],
    aspect_ratio: "16:9",
    resolution: "720p",
    duration: 8,
  }),
});
console.log(await r.json());

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]any{
        "model":        "grok-imagine-video-1.5-official",
        "prompt":       "Gentle cinematic push-in, golden-hour light, subtle motion",
        "image_urls":   []string{"https://your-cdn.com/source.jpg"},
        "aspect_ratio": "16:9",
        "resolution":   "720p",
        "duration":     8,
    })
    req, _ := http.NewRequest("POST",
        "https://reapi.ai/api/v1/videos/generations", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    out, _ := io.ReadAll(resp.Body)
    fmt.Println(string(out))
}

Submit response

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "grok-imagine-video-1.5-official",
  "status": "processing",
  "created_at": 1735000000
}

Poll GET /api/v1/tasks/{id} (see the Tasks reference) until status === "completed". The completed payload's output.video_urls holds the generated MP4 URL (with audio), valid for 7 days.

Authentication

Every call needs a Bearer token. Generate keys at reapi.ai/settings/apikeys.

Authorization: Bearer YOUR_API_KEY

Keys carry the active workspace's billing scope — there is no separate project header.

Endpoint

POST /api/v1/videos/generations
GET  /api/v1/tasks/{id}

Submission is async. The POST returns immediately with a task_id; the task endpoint returns the same envelope until completion. Polling does not consume credits.

This is an image-to-video model — exactly one reference image is required on every request. There is no text-to-video mode, no last-frame or reference image input, and no mode parameter.

Request body

model — required

string. Must be "grok-imagine-video-1.5-official".

prompt — string, required

Describes the motion, camera, atmosphere, and any dialogue or sound you want in the generated audio. Required on this channel (the beta channel accepts image-only requests; this one does not).

image_urls — string[], required

Array with exactly one public HTTP(S) image URL — the first frame the model animates. Accepted source formats: JPEG, PNG, WebP.

aspect_ratio — string, default "16:9"

Output framing. auto is not available on this channel. Output pixel size follows the ratio × resolution matrix:

resolution — string, default "480p"

480p or 720p. 720p costs 2× per second — see Pricing.

duration — integer, default 8

Output length in seconds. Any integer in [3, 15] — note the 3-second minimum (the beta channel starts at 1). Out-of-range → 400. Drives pricing linearly.

audio — boolean, default true

Whether the generated clip carries a native synchronized audio track. Set false for a silent video at the same per-second rate.

Each request produces exactly one video. For multiple takes, submit concurrent requests — each bills and refunds independently.

Response envelope

Submit and poll share the same shape — only status and output fill in over time.

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "grok-imagine-video-1.5-official",
  "status": "completed",
  "created_at": 1735000000,
  "output": {
    "video_urls": ["https://cdn.reapi.ai/media/tasks/018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e/0.mp4"]
  },
  "error": null
}

output.video_urls URLs are valid for 7 days — re-host to your own storage if you need them longer.

Validation errors

Pattern-match on code, not message — message strings carry request-specific context (field names, observed values) and are not a stable contract.

The full envelope is { "error": { "code", "message", "request_id" } } — see the Errors catalog for the wire format and request_id correlation tips.

Recipes

Minimum request

{
  "model": "grok-imagine-video-1.5-official",
  "prompt": "Slow push-in with ambient room tone",
  "image_urls": ["https://your-cdn.com/source.jpg"]
}

Directed motion + HD

{
  "model": "grok-imagine-video-1.5-official",
  "prompt": "Slow dolly forward, wind moving the hair, warm cinematic light",
  "image_urls": ["https://your-cdn.com/portrait.jpg"],
  "resolution": "720p",
  "duration": 10
}

Vertical social clip, no audio

{
  "model": "grok-imagine-video-1.5-official",
  "prompt": "Energetic motion, quick handheld feel",
  "image_urls": ["https://your-cdn.com/poster.jpg"],
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "duration": 6,
  "audio": false
}

Polling pattern

The task endpoint behaves identically to other video tasks. A pragmatic schedule:

0–5 minutes:    poll every 5s
5 min – 1 h:    back off gradually toward 1 min
≥ 1 h:          cap at 3 min between polls

A typical task completes in about a minute. The worker's wall-clock cap is 48 hours, comfortably above any realistic queue.

Pricing

Per-second rate by resolution — 720p costs 2× the 480p rate. This channel is priced independently of (and lower than) the beta channel. See current rates on the Grok Imagine Video 1.5 model page.

Bill formula (1 credit = $0.001):

credits = ceil(per_second_usd × duration × 1000)

Failed jobs refund automatically.

Tips

• Write the prompt like a shot direction. It is required here — lean into it: camera move, subject motion, atmosphere, and the sound you want.
• One clear subject image works best. A centered, well-lit reference with clean composition tracks identity and motion far better than a busy frame.
• Sweet-spot duration: 5–10 seconds. Longer clips raise wall-time without changing the per-second rate.
• Pick 720p for hero shots, 480p to save. The 720p rate is exactly 2× the 480p rate on this channel.

Related

• grok-imagine-video-1.5-beta
• grok-imagine-1.0-video
• Errors catalog
• Authentication
• Quickstart