Grok Imagine Video 1.5 Preview کو Rivya Public API v1 کے ذریعے ماڈل ID grok-imagine-video، معاون اِن پٹس، پیرامیٹرز، Files API قواعد، کریڈٹس اور جواب کی مثالوں کے ساتھ استعمال کریں۔

API کے ذریعے دستیابمتن یا URL تیار؛ حوالہ جاتی طریقے Files API استعمال کرتے ہیںویڈیو

API ماڈل ID

grok-imagine-video

اِن پٹس

text, file

Files API

حوالہ جاتی طریقوں کے لیے ضروری

بنیادی کریڈٹس

per_output_second · 480p=2.4 · 720p=4.5 · ⌈total⌉

صلاحیت

ویڈیو

بلنگ

METERED

پرامپٹ کی حد

4096 حروف

درخواست کا معاہدہ

`model` ID کو بالائی سطح پر بھیجیں۔ ماڈل کے مخصوص کنٹرولز `params` میں رہتے ہیں۔

کلید	قسم	ضروری	طے شدہ	وضاحت
model	string	ہاں	grok-imagine-video	API ماڈل ID کے طور پر grok-imagine-video استعمال کریں۔
prompt	string	ہاں	-	اس ماڈل کے لیے زیادہ سے زیادہ 4096 حروف۔
params	object	نہیں	-	ماڈل کا مخصوص پیرامیٹر آبجیکٹ۔ اجازت یافتہ کلیدوں کے لیے نیچے والی قطاریں دیکھیں۔
client_request_id	string	نہیں	-	اپنے نظام میں درخواستوں کا سراغ رکھنے کے لیے اختیاری صارف طرفہ ID۔

ماڈل پیرامیٹرز

کلید	قسم	ضروری	طے شدہ	حد	اختیارات	وضاحت
duration	number	نہیں	8	min 1 / max 15 / step 1	-	دورانیہ
resolution	select	نہیں	480p	-	480p, 720p	ریزولوشن
aspect_ratio	select	نہیں	auto	-	auto, 1:1, 16:9, 9:16, 3:2, 2:3	پہلو تناسب
nsfw_checker	select	نہیں	true	-	true, false	Content filter

اپ لوڈ پالیسی

حوالہ جاتی فائلیں پہلے اپ لوڈ کریں، پھر واپس ملنے والا URL اور دورانیے کا ٹوکن `params.referenceMediaItems` میں رکھیں۔

حوالے کا قاعدہ

حوالہ تصویر: زیادہ سے زیادہ 7 JPEG، PNG یا WebP تصاویر، ہر ایک زیادہ سے زیادہ 20MB۔

زیادہ سے زیادہ فائلیں

قبول شدہ فائل اقسام

image

دورانیے کا ٹوکن

دورانیے کی تصدیق ضروری ہو تو ویڈیو اور آڈیو حوالوں کو /api/v1/files سے ملنے والا `durationToken` ساتھ رکھنا چاہیے۔

kind	زیادہ سے زیادہ حجم	MIME اقسام
image	20 MB	image/jpeg, image/png, image/webp

کم سے کم درخواست

{
  "model": "grok-imagine-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": 8,
    "resolution": "480p",
    "aspect_ratio": "auto",
    "nsfw_checker": "true"
  }
}

حوالہ جاتی فائل کی درخواست

{
  "model": "grok-imagine-video",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": 8,
    "resolution": "480p",
    "aspect_ratio": "auto",
    "nsfw_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

تخلیقی جواب

تخلیقی اینڈ پوائنٹ عوامی کام کی ID واپس کرتا ہے۔ کام کے کامیاب یا ناکام ہونے تک حالت والے اینڈ پوائنٹ سے جانچتے رہیں۔

{
  "id": "task_grok_imagine_video_example",
  "status": "queued",
  "model": "grok-imagine-video",
  "reserved_credits": 20,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

عام خرابیاں

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

کچھ طریقوں کو Files API حوالہ جاتی اپ لوڈز درکار ہوتے ہیں۔

Grok Imagine Video 1.5 Preview API انضمام