يستقبل Grok Imagine Image 2.0 وصف المشهد وينشئ صورة. ويستطيع نموذج xAI أيضًا التعامل مع المادة المرئية الأصلية: تطبيق تعديلات بتعليمات نصية ومواصلة التحرير باستخدام النتيجة السابقة كمدخلات جديدة. وتُنشر في Ailoot طريقة التوليد من النص.
تصف xAI لنموذج Image 2.0 التصوير الواقعي والأنمي والرسم الزيتي والرسم بالقلم الرصاص. ويُحدد الأسلوب بالكلمات؛ وعند العمل بصورة أصلية تحدد التعليمات المظهر الجمالي المطلوب. وتتيح التعديلات المتتابعة إضافة التفاصيل وتنقيح النتيجة خطوة بخطوة.
n من 1 إلى 10 صور للوصف الواحد؛ والافتراضي صورة واحدة.aspect_ratio شكل الإطار؛ وتترك auto الاختيار للنموذج.resolution القيمة 1K أو 2K؛ والقيمة القياسية هي 1K.تتوفر الصيغ المربعة والأفقية والعمودية: 1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3 و2:1 و1:2. وتوجد صيغ الشاشات الطويلة 19.5:9 و9:19.5 و20:9 و9:20، وكذلك العريضة 21:9 و5:2.
يدعم Image 2.0 القيم low وmedium وauto. وتخص المعلمة هذا الإصدار تحديدًا؛ ويُستخدم auto إذا لم تُحدد الجودة. وفي تاريخ الفحص يختار النمط التلقائي low عند التوليد وmedium عند التحرير.
وفقًا لـxAI، يخصص النمط medium موارد حسابية أكثر للعمل على تفاصيل الصورة. ويثبّت الاختيار الصريح لـlow أو medium النمط المطلوب، بينما يتحدد سلوك auto بإعداد المصنّع الحالي.
للنموذج مدخلات نصية وبصرية، وتكون المخرجات صورًا. وفي نمط التحرير الخاص بـxAI يستقبل Image 2.0 حتى خمس صور أصلية؛ وتستخدم طريقة التوليد الحالية في Ailoot مدخلات نصية. ويمكن نقل النتيجة بملف عبر رابط أو بصيغة base64.
", "aboutText": "### توليد الصورة وتنقيحها\n\nيستقبل Grok Imagine Image 2.0 وصف المشهد وينشئ صورة. ويستطيع نموذج xAI أيضًا التعامل مع المادة المرئية الأصلية: تطبيق تعديلات بتعليمات نصية ومواصلة التحرير باستخدام النتيجة السابقة كمدخلات جديدة. وتُنشر في Ailoot طريقة التوليد من النص.\n\n### الأساليب البصرية\n\nتصف xAI لنموذج Image 2.0 التصوير الواقعي والأنمي والرسم الزيتي والرسم بالقلم الرصاص. ويُحدد الأسلوب بالكلمات؛ وعند العمل بصورة أصلية تحدد التعليمات المظهر الجمالي المطلوب. وتتيح التعديلات المتتابعة إضافة التفاصيل وتنقيح النتيجة خطوة بخطوة.\n\n### النسب والحجم والعدد\n\n- تحدد `n` من 1 إلى 10 صور للوصف الواحد؛ والافتراضي صورة واحدة.\n- تختار `aspect_ratio` شكل الإطار؛ وتترك `auto` الاختيار للنموذج.\n- تحدد `resolution` القيمة 1K أو 2K؛ والقيمة القياسية هي 1K.\n\nتتوفر الصيغ المربعة والأفقية والعمودية: `1:1` و`16:9` و`9:16` و`4:3` و`3:4` و`3:2` و`2:3` و`2:1` و`1:2`. وتوجد صيغ الشاشات الطويلة `19.5:9` و`9:19.5` و`20:9` و`9:20`، وكذلك العريضة `21:9` و`5:2`.\n\n### اختيار الجودة\n\nيدعم Image 2.0 القيم `low` و`medium` و`auto`. وتخص المعلمة هذا الإصدار تحديدًا؛ ويُستخدم `auto` إذا لم تُحدد الجودة. وفي تاريخ الفحص يختار النمط التلقائي `low` عند التوليد و`medium` عند التحرير.\n\nوفقًا لـxAI، يخصص النمط `medium` موارد حسابية أكثر للعمل على تفاصيل الصورة. ويثبّت الاختيار الصريح لـ`low` أو `medium` النمط المطلوب، بينما يتحدد سلوك `auto` بإعداد المصنّع الحالي.\n\n### المدخلات والنتيجة\n\nللنموذج مدخلات نصية وبصرية، وتكون المخرجات صورًا. وفي نمط التحرير الخاص بـxAI يستقبل Image 2.0 حتى خمس صور أصلية؛ وتستخدم طريقة التوليد الحالية في Ailoot مدخلات نصية. ويمكن نقل النتيجة بملف عبر رابط أو بصيغة base64.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "7021dd1a7cd7939567ccec0dfe63b928777d63b8d80ba0cd52a2f18d6c7e543a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "grok-imagine-image-2.0ينشئ Grok Imagine Image 2.0 صورًا من الوصف، مع إمكانية اختيار النسب والدقة والجودة. ويدعم النموذج نفسه أيضًا تحرير الصور ونقل الأسلوب البصري.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
يستقبل Grok Imagine Image 2.0 وصف المشهد وينشئ صورة. ويستطيع نموذج xAI أيضًا التعامل مع المادة المرئية الأصلية: تطبيق تعديلات بتعليمات نصية ومواصلة التحرير باستخدام النتيجة السابقة كمدخلات جديدة. وتُنشر في Ailoot طريقة التوليد من النص.
تصف xAI لنموذج Image 2.0 التصوير الواقعي والأنمي والرسم الزيتي والرسم بالقلم الرصاص. ويُحدد الأسلوب بالكلمات؛ وعند العمل بصورة أصلية تحدد التعليمات المظهر الجمالي المطلوب. وتتيح التعديلات المتتابعة إضافة التفاصيل وتنقيح النتيجة خطوة بخطوة.
n من 1 إلى 10 صور للوصف الواحد؛ والافتراضي صورة واحدة.aspect_ratio شكل الإطار؛ وتترك auto الاختيار للنموذج.resolution القيمة 1K أو 2K؛ والقيمة القياسية هي 1K.تتوفر الصيغ المربعة والأفقية والعمودية: 1:1 و16:9 و9:16 و4:3 و3:4 و3:2 و2:3 و2:1 و1:2. وتوجد صيغ الشاشات الطويلة 19.5:9 و9:19.5 و20:9 و9:20، وكذلك العريضة 21:9 و5:2.
يدعم Image 2.0 القيم low وmedium وauto. وتخص المعلمة هذا الإصدار تحديدًا؛ ويُستخدم auto إذا لم تُحدد الجودة. وفي تاريخ الفحص يختار النمط التلقائي low عند التوليد وmedium عند التحرير.
وفقًا لـxAI، يخصص النمط medium موارد حسابية أكثر للعمل على تفاصيل الصورة. ويثبّت الاختيار الصريح لـlow أو medium النمط المطلوب، بينما يتحدد سلوك auto بإعداد المصنّع الحالي.
للنموذج مدخلات نصية وبصرية، وتكون المخرجات صورًا. وفي نمط التحرير الخاص بـxAI يستقبل Image 2.0 حتى خمس صور أصلية؛ وتستخدم طريقة التوليد الحالية في Ailoot مدخلات نصية. ويمكن نقل النتيجة بملف عبر رابط أو بصيغة base64.
POST /v1/images/generationstextimage| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود grok-imagine-image-2.0 | القيمة الافتراضية— |
الحقلprompt | النوعstring | المتطلبمطلوب | القيم والحدود | القيمة الافتراضية— |
الحقلn | النوعinteger | المتطلباختياري | القيم والحدود الحد الأدنى: 1 الحد الأقصى: 10 | القيمة الافتراضية1 |
الحقلresponse_format | النوعstring | المتطلباختياري | القيم والحدود url, b64_json | القيمة الافتراضيةurl |
الحقلresolution | النوعstring | المتطلباختياري | القيم والحدود 1k, 2k | القيمة الافتراضية1k |
الحقلaspect_ratio | النوعstring | المتطلباختياري | القيم والحدود auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9, 5:2 | القيمة الافتراضيةauto |
الحقلquality | النوعstring | المتطلباختياري | القيم والحدود low, medium, auto | القيمة الافتراضية— |
تحويل النص إلى صورة · مطلوب: prompt
| المعلمة | المواصفات |
|---|---|
المعلمةmaterial_types | المواصفاتtext |
المعلمةrequired | المواصفاتmodel, prompt |
المعلمةoptional_controls | المواصفاتnull |
المعلمةcontent_type | المواصفاتapplication/json |
دورة الحياة: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/images/generationsتحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\nexport AILOOT_API_KEY\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 image brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "grok-imagine-image-2.0", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\nsave_images(json.loads(Path("result.json").read_text())["data"])\nPY_RESULT\nfrom openai import OpenAI\nimport base64, json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urlsplit, urljoin\n\ndef save_images(items):\n if not items: raise SystemExit("No completed images; retain the full response")\n for index, item in enumerate(items):\n encoded=item.get("b64_json")\n uri=item.get("url", "")\n if not encoded and uri.startswith("data:image/"):\n header, separator, encoded=uri.partition(",")\n if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")\n if encoded:\n raw=base64.b64decode(encoded,validate=True)\n elif uri:\n uri=urljoin("https://api.ailoot.ai",uri)\n parsed=urlsplit(uri)\n if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:\n raise SystemExit("Invalid returned image URL")\n owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",uri]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n temporary=Path(f"image-{index}.bin")\n subprocess.run(args+["-o",str(temporary)],check=True)\n raw=temporary.read_bytes()\n temporary.unlink()\n else: raise SystemExit("Image has neither bytes nor URL")\n if not raw: raise SystemExit("Empty image result")\n ext="png" if raw.startswith(b"\\x89PNG") else "jpg" if raw.startswith(b"\\xff\\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"\n Path(f"image-{index}.{ext}").write_bytes(raw)\n print("Every returned image saved; complete response metadata retained")\n\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Set your actual UTF-8 image brief file")\nrequest={'model': 'grok-imagine-image-2.0', 'prompt': ''}\nrequest["prompt"]=f.read_text(encoding="utf-8")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.images.generate(**request)\nPath("sdk-result.txt").write_text(str(result),encoding="utf-8")\nsave_images([{"b64_json":getattr(item,"b64_json",None),"url":getattr(item,"url",None)} for item in result.data])\nimport OpenAI from "openai";\nimport { readFileSync, writeFileSync } from "node:fs";\nconst key=process.env.AILOOT_API_KEY;\nif(!key) throw new Error("Set your actual Ailoot API key");\nconst client=new OpenAI({baseURL:"https://api.ailoot.ai/v1",apiKey:key,maxRetries:0});\nconst request={"model": "grok-imagine-image-2.0", "prompt": ""};\nif(!process.env.AILOOT_PROMPT_FILE)throw new Error("Set your actual UTF-8 image brief file");\nrequest.prompt=readFileSync(process.env.AILOOT_PROMPT_FILE,"utf8");\nconst result=await client.images.generate(request);\nwriteFileSync("sdk-result.json",JSON.stringify(result,null,2));\nif(!result.data?.length) throw new Error("No completed images");\nfor(let index=0;index<result.data.length;index++) {\n const item=result.data[index];let encoded=item.b64_json,uri=item.url||"",raw;\n if(!encoded && uri.startsWith("data:image/")) {\n const comma=uri.indexOf(",");if(comma<0 || !uri.slice(0,comma).includes(";base64")) throw new Error("Unsupported image data URI");\n encoded=uri.slice(comma+1);\n }\n if(encoded) {\n if(encoded.length%4!==0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(encoded)) throw new Error("Invalid Base64");\n raw=Buffer.from(encoded,"base64");\n } else if(uri) {\n const u=new URL(uri,"https://api.ailoot.ai");\n if(u.protocol!=="https:" || u.username || u.password) throw new Error("Invalid returned URL");\n const owned=u.origin==="https://api.ailoot.ai" && u.pathname.startsWith("/v1/media/assets/") && u.pathname.endsWith("/content");\n const response=await fetch(u,{headers:owned?{Authorization:"Bearer "+key}:{},redirect:"manual"});\n if(!response.ok) throw new Error("Image content download failed: "+response.status);\n raw=Buffer.from(await response.arrayBuffer());\n } else throw new Error("Image has neither bytes nor URL");\n if(!raw.length) throw new Error("Empty image result");\n const ext=raw.subarray(0,4).equals(Buffer.from([137,80,78,71]))?"png":raw[0]===255&&raw[1]===216?"jpg":raw.toString("ascii",0,4)==="RIFF"&&raw.toString("ascii",8,12)==="WEBP"?"webp":raw.toString("utf8").trimStart().startsWith("<svg")||raw.toString("utf8").trimStart().startsWith("<?xml")?"svg":"bin";\n writeFileSync(`image-${index}.${ext}`,raw);\n}\nconsole.log("Every returned image saved; sdk-result.json retains complete metadata");\nنزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}احفظ كل صورة مكتملة؛ نزّلها من كل URL مُرجع، أو فك ترميز محتواها بصيغة Base64.
احفظ كل عنصر بيانات. فك ترميز كل b64_json أو اجلب محتوى كل عنوان URL موقّع مُعاد. اختر امتداد اسم الملف بناءً على نوع MIME والبايتات الفعلية.
إذا تطلبت نتيجة توليد صورة أو تعديلها التحقق، فاحتفظ بقيمة operation_id/X-Client-Request-ID الأصلية ومعلومات النتيجة المُعادة. استعد النتائج الموجودة والمملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تُعِد إرسال طلب التوليد أو التعديل، ولا تنشئ عنوان URL للاستعلام الدوري من operation_id.
| الحقل | النوع |
|---|---|
الحقلcreated | النوعinteger |
الحقلdata[].url | النوعstring |
الحقلdata[].b64_json | النوعbase64 string |
الحقلusage | النوعobject |
| الاستجابة | الشرط | الخطوة التالية |
|---|---|---|
الاستجابة400 · invalid_request_error | الشرطحقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة | الخطوة التاليةصحّح الحقول المحددة قبل طلب إنشاء جديد. |
الاستجابةserver_error | الشرطتشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق | الخطوة التاليةاحتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء. |
Ailoot grok-imagine-image-2.0
استخدم مسارات الطرائق المعروضة أعلاه.