تخطّي إلى المحتوى

Grok Imagine Image 2.0 · Text to Image

التكامل

معرّف النموذج xai/grok-imagine-image/v2.0/text-to-image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.06 $⁩ 60 رصيد API · ≈ ⁨‏6.45 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
xAI من نص إلى صورة حتى 2k #text-to-image#xai#grok

تحويل النص إلى صورة باستخدام Grok Imagine 2.0 مع 13 نسبة أبعاد ودقة 1k أو 2k وما يصل إلى 4 صور

xAI · صورة

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب 88 / 8000

وصف نصي للصورة المطلوب إنشاؤها.

resolution الافتراضي 1k

اختيار دقة الصورة بين القياسية (`1k`) والعالية (`2k`).

quality الافتراضي medium

إعداد جودة الصورة المُولّدة.

الافتراضي 1:1

نسبة العرض إلى الارتفاع لصورة المخرج.

num_images الافتراضي 1

عدد الصور المطلوب إنتاجها.

متقدم output_format · enable_safety_checker
output_format الافتراضي jpeg

تنسيق ملف الصورة الناتجة.

POST /run/xai/grok-imagine-image/v2.0/text-to-image?wait=20 عرض السعر → ⁨‏0.06 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/xai/grok-imagine-image/v2.0/text-to-image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Grok Imagine Image 2.0 · Text to Image

ينشئ صورًا من `prompt` نصية يصل طولها إلى 8000 حرف. ينتج من 1 إلى 4 صور لكل استدعاء، مع 13 نسبة أبعاد من 1:2 إلى 2:1 (الافتراضي 1:1) ودقة `1k` أو `2k`. يمكن أن يكون الإخراج بصيغة jpeg أو png أو webp، مع `quality` بقيمة low أو medium. تتضمن الاستجابة المطالبة المنقحة المستخدمة فعليًا.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
≤ 8,000 حرف
وصف نصي للصورة المطلوب إنشاؤها.
num_imagesاختياري num_outputs
النوعinteger
الافتراضي1
1 – 4
عدد الصور المطلوب إنتاجها.
aspect_ratioاختياري
النوعenum
الافتراضي1:1
2:120:919.5:916:94:33:21:12:33:49:169:19.59:201:2
نسبة العرض إلى الارتفاع لصورة المخرج.
resolutionاختياري
النوعenum
الافتراضي1k
1k2k
اختيار دقة الصورة بين القياسية (`1k`) والعالية (`2k`).
output_formatاختياري
النوعenum
الافتراضيjpeg
jpegpngwebp
تنسيق ملف الصورة الناتجة.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
qualityاختياري
النوعenum
الافتراضيmedium
lowmedium
إعداد جودة الصورة المُولّدة.
مطلوب الاسم الأساسي، مقبول أيضًا

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "xai/grok-imagine-image/v2.0/text-to-image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 60,
    "usd": "0.06",
    "charged": 60,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ],
    "revised_prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
images
array of object {url, content_type, file_name, file_size, width, height}رابط يشير إلى الصورة المولدة.
revised_prompt
string | nullالموجّه المحسّن المستخدم لتوليد الصورة.

مزيد من النماذج: من نص إلى صورة

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/xai/grok-imagine-image/v2.0/text-to-image.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt