grok-imagine-1.0-video

Quick example

curl https://reapi.ai/api/v1/videos/generations \
  -H "Authorization: Bearer rk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-1.0-video",
    "prompt": "A dog running on a sunlit beach, slow-motion",
    "size": "16:9",
    "duration": 6,
    "quality": "720p"
  }'

import requests

resp = requests.post(
    "https://reapi.ai/api/v1/videos/generations",
    headers={
        "Authorization": "Bearer rk_live_xxx",
        "Content-Type": "application/json",
    },
    json={
        "model": "grok-imagine-1.0-video",
        "prompt": "A dog running on a sunlit beach, slow-motion",
        "size": "16:9",
        "duration": 6,
        "quality": "720p",
    },
    timeout=30,
)
print(resp.json())

const r = await fetch("https://reapi.ai/api/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer rk_live_xxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-1.0-video",
    prompt: "A dog running on a sunlit beach, slow-motion",
    size: "16:9",
    duration: 6,
    quality: "720p",
  }),
});
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-1.0-video",
        "prompt":   "A dog running on a sunlit beach, slow-motion",
        "size":     "16:9",
        "duration": 6,
        "quality":  "720p",
    })
    req, _ := http.NewRequest("POST",
        "https://reapi.ai/api/v1/videos/generations", bytes.NewReader(body))
    req.Header.Set("Authorization", "Bearer rk_live_xxx")
    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-1.0-video",
  "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, 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.

Mode routing

grok-imagine-1.0-video picks its mode from the count of image_urls you send — there is no mode parameter:

Request body

model — required

string. Must be "grok-imagine-1.0-video".

prompt — string, conditional

Up to 4,000 characters. Required in T2V (when image_urls is empty); optional in I2V when at least one image is provided.

Empty / whitespace-only prompts are treated as missing.

size — string, default "16:9"

Output aspect ratio in T2V mode. One of:

In I2V mode the upstream derives the ratio from the reference image, so this field is ignored.

duration — integer, default 6

Output length in seconds. Any integer in [6, 30]. Out-of-range → 400. Drives pricing linearly: ceil(per_second_usd × duration × 1000) credits (1 credit = $0.001).

quality — string, default "480p"

480p (SD) or 720p (HD). Lowercase is canonical. Quality does not change the per-second rate.

image_urls — string[]

Array of public HTTP(S) URLs. 0 to 7 entries:

• 0 entries — pure text-to-video.
• 1 to 7 entries — image-to-video; references guide subject and style.

Response envelope

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

{
  "id": "task_018f5a3a1b6e7d9f8c2b4d6e8f0a2c4e",
  "model": "grok-imagine-1.0-video",
  "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

All cases below return HTTP 400 with code 20003 unless noted. Pattern-match on code, not message — message strings carry request-specific context (field names, observed values, etc.) and are not a stable contract.

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

Recipes

T2V — minimum request

{
  "model": "grok-imagine-1.0-video",
  "prompt": "A little girl walking down a sunset coastal road"
}

T2V — full parameters

{
  "model": "grok-imagine-1.0-video",
  "prompt": "A dog running on a sunlit beach, slow-motion, cinematic warm tones",
  "size": "16:9",
  "duration": 10,
  "quality": "720p"
}

I2V — animate from references

{
  "model": "grok-imagine-1.0-video",
  "prompt": "Bring the scene to life with a gentle camera dolly forward",
  "image_urls": ["https://your-cdn.com/reference.jpg"],
  "duration": 8,
  "quality": "720p"
}

I2V — multi-reference

{
  "model": "grok-imagine-1.0-video",
  "prompt": "Smooth cinematic motion across the reference subjects",
  "image_urls": [
    "https://your-cdn.com/ref-1.jpg",
    "https://your-cdn.com/ref-2.jpg",
    "https://your-cdn.com/ref-3.jpg"
  ],
  "duration": 12
}

Polling pattern

The task endpoint behaves identically to other video tasks — the only difference is the completed output shape (video_urls instead of image_urls). 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 a few minutes. The worker's wall-clock cap is 48 hours, comfortably above any realistic queue.

Pricing

Per-second rate. quality does not change the price, and the rate is flat across 480p and 720p. See current rate on the Grok Imagine model page.

Bill formula (1 credit = $0.001):

credits = ceil(per_second_usd × duration × 1000)

Failed jobs refund automatically.

Tips

• Prompt motion, not just scene. "Slow push-in, warm tones, shallow depth of field" outperforms a pure noun-list of what's on screen.
• Sweet-spot duration: 6–10 seconds. Above 10s the upstream wall-time grows fast; the per-second price stays the same either way.
• Reference-image quality matters. Subject centered, clear composition, no heavy filters — I2V output quality tracks input quality directly.
• Send up to 7 references for richer guidance. A first frame plus several style boards usually outperforms a single reference.

Related

• Errors catalog
• Authentication
• Quickstart