Rivya AI ডকস
মডেল API পেজ

Grok Imagine Image 2.0 API ইন্টিগ্রেশন

Rivya Public API v1 দিয়ে Grok Imagine Image 2.0 ব্যবহার করুন: model id grok-imagine-image-2-0, সমর্থিত ইনপুট, প্যারামিটার, Files API নিয়ম, ক্রেডিট এবং response উদাহরণসহ।

API দিয়ে উপলভ্যটেক্সট বা URL প্রস্তুত; reference modes Files API ব্যবহার করেছবি
API model id

grok-imagine-image-2-0

ইনপুট

text, file

Files API

reference mode-এর জন্য প্রয়োজন

বেস ক্রেডিট

per_image · text_to_image=4 · image_edit=4 · ⌈total⌉

ক্ষমতা

ছবি

বিলিং

FIXED

প্রম্পট সীমা

20000 অক্ষর

রিকোয়েস্ট contract

model id top level-এ পাঠান। Model-specific control params-এ থাকবে।

Keyধরনপ্রয়োজনীয়ডিফল্টবিবরণ
modelstringহ্যাঁgrok-imagine-image-2-0grok-imagine-image-2-0 API model id ব্যবহার করুন।
promptstringহ্যাঁ-এই model-এর জন্য সর্বোচ্চ 20000 অক্ষর।
paramsobjectনা-মডেল-নির্দিষ্ট প্যারামিটার object। অনুমোদিত key-এর জন্য নিচের row ব্যবহার করুন।
client_request_idstringনা-আপনার সিস্টেমে request trace করার ঐচ্ছিক client-side id।

মডেল প্যারামিটার

Keyধরনপ্রয়োজনীয়ডিফল্টপরিসরবিকল্পবিবরণ
aspect_ratioselectনা1:1-1:1, 2:3, 3:2, 16:9, 9:16, autoঅন্তত একটি রেফারেন্স ছবি আপলোড করার পরেই স্বয়ংক্রিয় বিকল্প পাওয়া যায়।

আপলোড নীতি

প্রথমে reference file upload করুন, তারপর ফেরত পাওয়া URL এবং duration token params.referenceMediaItems-এর মধ্যে দিন।

রেফারেন্স নিয়ম

রেফারেন্স ছবি: এক থেকে পাঁচটি JPEG, PNG বা WebP ছবি আপলোড করুন, প্রতিটি 10 MB-এর বেশি নয়। প্রতিটি রেফারেন্সের জন্য স্বাক্ষরিত আপলোড মেটাডেটা প্রয়োজন।

সর্বোচ্চ ফাইল

5

সমর্থিত ফাইল ধরন

image

Duration token

duration verification প্রয়োজন হলে video এবং audio reference /api/v1/files থেকে durationToken বহন করবে।

kindসর্বোচ্চ আকারMIME types
image10 MBimage/jpeg, image/png, image/webp

ন্যূনতম request

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

রেফারেন্স ফাইল রিকোয়েস্ট

{
  "model": "grok-imagine-image-2-0",
  "prompt": "A clean editorial product image on a soft studio background",
  "params": {
    "aspect_ratio": "1:1",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Create response

create endpoint public task id ফেরত দেয়। task succeeded বা failed না হওয়া পর্যন্ত status endpoint poll করুন।

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

কিছু mode-এর জন্য Files API reference upload দরকার।