Rivya Public API v1 के जरिए मॉडल id grok-imagine, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Grok Imagine का उपयोग करें।

API से उपलब्धटेक्स्ट या URL तैयार; संदर्भ mode में Files API का उपयोग होता हैइमेज

API मॉडल id

grok-imagine

इनपुट

text, file

Files API

संदर्भ mode के लिए जरूरी

बेस क्रेडिट

क्षमता

इमेज

बिलिंग

FIXED

प्रॉम्प्ट सीमा

5000 अक्षर

रिक्वेस्ट अनुबंध

मॉडल id को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।

Key	प्रकार	जरूरी	डिफॉल्ट	विवरण
model	string	हां	grok-imagine	grok-imagine API मॉडल id का उपयोग करें।
prompt	string	हां	-	इस मॉडल के लिए अधिकतम 5000 अक्षर।
params	object	नहीं	-	मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें।
client_request_id	string	नहीं	-	अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id।

मॉडल पैरामीटर

Key	प्रकार	जरूरी	डिफॉल्ट	सीमा	विकल्प	विवरण
aspect_ratio	select	नहीं	1:1	-	1:1, 2:3, 3:2, 16:9, 9:16	आस्पेक्ट रेशियो
enable_pro	select	नहीं	false	-	false, true	यह Grok Imagine का केवल टेक्स्ट-से-इमेज के लिए गुणवत्ता टॉगल है। मानक सस्ता है, जबकि गुणवत्ता ज्यादा विवरण की ओर झुकती है; मौजूदा इमेज-संपादन पथ इसका उपयोग नहीं करता।

अपलोड नीति

पहले संदर्भ फाइल अपलोड करें, फिर लौटे हुए URL और duration token को params.referenceMediaItems में रखें।

संदर्भ नियम

संदर्भ इमेज: इमेज प्रोजेक्ट के लिए अधिकतम 1 इमेज फाइल अपलोड करें।

अधिकतम फाइलें

स्वीकार्य फाइल प्रकार

image

अवधि token

अवधि सत्यापन जरूरी होने पर वीडियो और ऑडियो संदर्भों में /api/v1/files से मिला durationToken होना चाहिए।

kind	अधिकतम आकार	MIME प्रकार
image	10 MB	image/jpeg, image/png, image/webp

न्यूनतम रिक्वेस्ट

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false"
  }
}

संदर्भ फाइल रिक्वेस्ट

{
  "model": "grok-imagine",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "enable_pro": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

रिस्पॉन्स बनाएं

Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।

{
  "id": "task_grok_imagine_example",
  "status": "queued",
  "model": "grok-imagine",
  "reserved_credits": 4,
  "final_credits": 0,
  "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

कुछ mode में Files API संदर्भ अपलोड जरूरी हैं।

Grok Imagine API इंटीग्रेशन