{ "aboutHtml": "

التوليد والتعامل مع الصور

GPT Image 2.5 Sunburst نموذج من OpenAI لإنشاء الصور. ويولي المصنّع اهتمامًا خاصًا لدقة تحرير المواد الأصلية. يدعم النموذج المهام النصية، وفي العمليات المخصصة لذلك، الصور الأصلية.

تعرض بطاقة Ailoot الحالية نمط إنشاء الصورة من النص. ويمكن تحديد المشهد والتكوين والأسلوب وتفاصيل النتيجة القادمة. وتتطلب الطرق التي تصفها OpenAI للعمل بالصور المرجعية والتحرير وتعديل منطقة بقناع دعمًا مستقلًا للصور كمدخلات؛ ولا يؤكد توافر التوليد النصي هذا الدعم.

الجودة وشكل الإطار

تتوفر low وmedium وhigh وxhigh وmax وauto. ويتحكم اختيار الجودة في نمط تكوين الصورة. وهو يختلف عن أبعاد التكوين وعن درجة ضغط الملف الناتج.

يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو مختارًا تلقائيًا أو محددًا يدويًا. وفي الحجم المخصص يكون كل ضلع من مضاعفات 16 بكسلًا ولا يتجاوز 3840 بكسلًا. ويجب أن تكون المساحة بين 655 360 و8 294 400 بكسل، وألا تتجاوز نسبة طول الضلع الطويل إلى القصير 3:1. وتُطبق جميع الشروط في آن واحد.

يصف المصنّع الدقات الأعلى من 2560x1440 بأنها تجريبية. يتيح الإطار الكبير اختيار مساحة مناسبة للتكوين، لكنه لا يغني عن التحقق من الكتابات ومواضع الأشياء.

صيغ النتيجة والخلفية

تُستخدم PNG افتراضيًا؛ وتتوفر أيضًا JPEG وWebP. ويمكن ضبط الضغط في JPEG وWebP. وتتطلب الخلفية الشفافة PNG أو WebP، لأن JPEG لا تحتفظ بقناة ألفا. وإلى جانب الشفافية تتوفر الخلفية غير الشفافة والاختيار التلقائي.

يتحكم الحجم والجودة والصيغة والخلفية في جوانب مختلفة من النتيجة. ويُحدد أسلوب الصورة بوصف نصي إلى جانب محتوى المشهد. وينبغي مراعاة دعم الإعدادات المحددة بصورة مستقلة عن الإمكانات العامة للمصنّع.

دقة التحرير والتحقق من الصورة

وفقًا لـOpenAI، قد تستغرق معالجة مهمة معقدة حتى دقيقتين. وهذا وصف للتوليد لدى المصنّع، وليس ضمانًا للوقت الكامل لتلقي النتيجة في تطبيق معين.

في عملية التحرير المدعومة بصورة مستقلة، يوجه القناع تعديل المنطقة المختارة. ولا يضمن تطابق النتيجة الصارم مع الحدود، لذا سيكون الوعد بتحرير موضعي دقيق أقوى مما تسمح به هذه الإمكانية. ويتطلب هذا النمط طريقة مناسبة لتقديم الصورة الأصلية.

عند التوليد قد يخطئ النموذج أيضًا في مواضع النص والتفاصيل أو يغير مظهر الشخصية بين الصور المنفصلة. ويندرج التحقق من الكتابات والتكوين وثبات المظهر ضمن مراجعة الملف النهائي. ولا تجعل المهمة المفصلة هذه الخصائص مضمونة.

", "aboutText": "### التوليد والتعامل مع الصور\n\nGPT Image 2.5 Sunburst نموذج من OpenAI لإنشاء الصور. ويولي المصنّع اهتمامًا خاصًا لدقة تحرير المواد الأصلية. يدعم النموذج المهام النصية، وفي العمليات المخصصة لذلك، الصور الأصلية.\n\nتعرض بطاقة Ailoot الحالية نمط إنشاء الصورة من النص. ويمكن تحديد المشهد والتكوين والأسلوب وتفاصيل النتيجة القادمة. وتتطلب الطرق التي تصفها OpenAI للعمل بالصور المرجعية والتحرير وتعديل منطقة بقناع دعمًا مستقلًا للصور كمدخلات؛ ولا يؤكد توافر التوليد النصي هذا الدعم.\n\n### الجودة وشكل الإطار\n\nتتوفر `low` و`medium` و`high` و`xhigh` و`max` و`auto`. ويتحكم اختيار الجودة في نمط تكوين الصورة. وهو يختلف عن أبعاد التكوين وعن درجة ضغط الملف الناتج.\n\nيمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو مختارًا تلقائيًا أو محددًا يدويًا. وفي الحجم المخصص يكون كل ضلع من مضاعفات 16 بكسلًا ولا يتجاوز 3840 بكسلًا. ويجب أن تكون المساحة بين 655 360 و8 294 400 بكسل، وألا تتجاوز نسبة طول الضلع الطويل إلى القصير 3:1. وتُطبق جميع الشروط في آن واحد.\n\nيصف المصنّع الدقات الأعلى من `2560x1440` بأنها تجريبية. يتيح الإطار الكبير اختيار مساحة مناسبة للتكوين، لكنه لا يغني عن التحقق من الكتابات ومواضع الأشياء.\n\n### صيغ النتيجة والخلفية\n\nتُستخدم PNG افتراضيًا؛ وتتوفر أيضًا JPEG وWebP. ويمكن ضبط الضغط في JPEG وWebP. وتتطلب الخلفية الشفافة PNG أو WebP، لأن JPEG لا تحتفظ بقناة ألفا. وإلى جانب الشفافية تتوفر الخلفية غير الشفافة والاختيار التلقائي.\n\nيتحكم الحجم والجودة والصيغة والخلفية في جوانب مختلفة من النتيجة. ويُحدد أسلوب الصورة بوصف نصي إلى جانب محتوى المشهد. وينبغي مراعاة دعم الإعدادات المحددة بصورة مستقلة عن الإمكانات العامة للمصنّع.\n\n### دقة التحرير والتحقق من الصورة\n\nوفقًا لـOpenAI، قد تستغرق معالجة مهمة معقدة حتى دقيقتين. وهذا وصف للتوليد لدى المصنّع، وليس ضمانًا للوقت الكامل لتلقي النتيجة في تطبيق معين.\n\nفي عملية التحرير المدعومة بصورة مستقلة، يوجه القناع تعديل المنطقة المختارة. ولا يضمن تطابق النتيجة الصارم مع الحدود، لذا سيكون الوعد بتحرير موضعي دقيق أقوى مما تسمح به هذه الإمكانية. ويتطلب هذا النمط طريقة مناسبة لتقديم الصورة الأصلية.\n\nعند التوليد قد يخطئ النموذج أيضًا في مواضع النص والتفاصيل أو يغير مظهر الشخصية بين الصور المنفصلة. ويندرج التحقق من الكتابات والتكوين وثبات المظهر ضمن مراجعة الملف النهائي. ولا تجعل المهمة المفصلة هذه الخصائص مضمونة.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b58013075b7fda54c5eb52172540045603f9fb74ad552960ae124d32d391d7a8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "

O

GPT Image 2.5 Sunburst 2026-09-08

OpenAI /gpt-image-2.5-sunburst-2026-09-08

البداية

ينشئ GPT Image 2.5 Sunburst صورًا من مهمة نصية. ويدعم أحجامًا مخصصة ومستويات جودة موسعة وخلفية شفافة؛ ويبرز المصنّع أيضًا دقة التحرير.

المدخلات المقبولة: النص
النتائج: الصور

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

التوليد والتعامل مع الصور

GPT Image 2.5 Sunburst نموذج من OpenAI لإنشاء الصور. ويولي المصنّع اهتمامًا خاصًا لدقة تحرير المواد الأصلية. يدعم النموذج المهام النصية، وفي العمليات المخصصة لذلك، الصور الأصلية.

تعرض بطاقة Ailoot الحالية نمط إنشاء الصورة من النص. ويمكن تحديد المشهد والتكوين والأسلوب وتفاصيل النتيجة القادمة. وتتطلب الطرق التي تصفها OpenAI للعمل بالصور المرجعية والتحرير وتعديل منطقة بقناع دعمًا مستقلًا للصور كمدخلات؛ ولا يؤكد توافر التوليد النصي هذا الدعم.

الجودة وشكل الإطار

تتوفر low وmedium وhigh وxhigh وmax وauto. ويتحكم اختيار الجودة في نمط تكوين الصورة. وهو يختلف عن أبعاد التكوين وعن درجة ضغط الملف الناتج.

يمكن أن يكون الحجم مربعًا أو أفقيًا أو عموديًا أو مختارًا تلقائيًا أو محددًا يدويًا. وفي الحجم المخصص يكون كل ضلع من مضاعفات 16 بكسلًا ولا يتجاوز 3840 بكسلًا. ويجب أن تكون المساحة بين 655 360 و8 294 400 بكسل، وألا تتجاوز نسبة طول الضلع الطويل إلى القصير 3:1. وتُطبق جميع الشروط في آن واحد.

يصف المصنّع الدقات الأعلى من 2560x1440 بأنها تجريبية. يتيح الإطار الكبير اختيار مساحة مناسبة للتكوين، لكنه لا يغني عن التحقق من الكتابات ومواضع الأشياء.

صيغ النتيجة والخلفية

تُستخدم PNG افتراضيًا؛ وتتوفر أيضًا JPEG وWebP. ويمكن ضبط الضغط في JPEG وWebP. وتتطلب الخلفية الشفافة PNG أو WebP، لأن JPEG لا تحتفظ بقناة ألفا. وإلى جانب الشفافية تتوفر الخلفية غير الشفافة والاختيار التلقائي.

يتحكم الحجم والجودة والصيغة والخلفية في جوانب مختلفة من النتيجة. ويُحدد أسلوب الصورة بوصف نصي إلى جانب محتوى المشهد. وينبغي مراعاة دعم الإعدادات المحددة بصورة مستقلة عن الإمكانات العامة للمصنّع.

دقة التحرير والتحقق من الصورة

وفقًا لـOpenAI، قد تستغرق معالجة مهمة معقدة حتى دقيقتين. وهذا وصف للتوليد لدى المصنّع، وليس ضمانًا للوقت الكامل لتلقي النتيجة في تطبيق معين.

في عملية التحرير المدعومة بصورة مستقلة، يوجه القناع تعديل المنطقة المختارة. ولا يضمن تطابق النتيجة الصارم مع الحدود، لذا سيكون الوعد بتحرير موضعي دقيق أقوى مما تسمح به هذه الإمكانية. ويتطلب هذا النمط طريقة مناسبة لتقديم الصورة الأصلية.

عند التوليد قد يخطئ النموذج أيضًا في مواضع النص والتفاصيل أو يغير مظهر الشخصية بين الصور المنفصلة. ويندرج التحقق من الكتابات والتكوين وثبات المظهر ضمن مراجعة الملف النهائي. ولا تجعل المهمة المفصلة هذه الخصائص مضمونة.

متاح في Ailoot · المدخلات والطرائق

Ailoot · الصور POST /v1/images/generations

الإدخال: text
الإخراج: image
صيغة الإخراج: ملف صورة

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود gpt-image-2.5-sunburst-2026-09-08	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩	القيمة الافتراضية⁦1⁩
الحقل`response_format`	النوع`string`	المتطلباختياري	القيم والحدود url, b64_json	القيمة الافتراضية—
الحقل`stream`	النوع`boolean`	المتطلباختياري	القيم والحدود	القيمة الافتراضيةfalse
الحقل`size`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`output_format`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`output_compression`	النوع`integer`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`moderation`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`input_fidelity`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`style`	النوع`string`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—
الحقل`partial_images`	النوع`integer`	المتطلباختياري	القيم والحدود يعتمد على النموذج	القيمة الافتراضية—

تركيبات مواد الإدخال

تحويل النص إلى صورة · مطلوب: 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}

بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.

الباقات

تعرفات طرائق Ailoot

Ailoot الصورPOST /v1/images/generations

إدخال النص: ⁦‏0.005 US$⁩ / 1K
الإدخال، صورة: ⁦‏0.008 US$⁩ / 1K tokens
الإخراج، صورة: ⁦‏0.03 US$⁩ / 1K tokens

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

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": "gpt-image-2.5-sunburst-2026-09-08", "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\n

from 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': 'gpt-image-2.5-sunburst-2026-09-08', '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])\n

import 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": "gpt-image-2.5-sunburst-2026-09-08", "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

استلام النتائج وحفظها

Ailoot · الصور

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /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 gpt-image-2.5-sunburst-2026-09-08

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

gpt-image-2.5-sunburst-2026-09-08

", "method_identity": { "effective_request_model_id": "gpt-image-2.5-sunburst-2026-09-08", "fmt": "images", "http": "POST", "path": "/v1/images/generations", "request_model_id": "gpt-image-2.5-sunburst-2026-09-08", "route_label": "Core" }, "method_key": "Core|images|/v1/images/generations|gpt-image-2.5-sunburst-2026-09-08", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save every data item. Decode each b64_json or fetch every returned signed URL. Select a filename extension from the actual MIME/bytes.", "errors": [ { "code": null, "condition": "حقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة", "http_status": 400, "recovery": "صحّح الحقول المحددة قبل طلب إنشاء جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "تشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق", "http_status": null, "recovery": "احتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "إذا تطلبت نتيجة توليد صورة أو تعديلها التحقق، فاحتفظ بقيمة operation_id/X-Client-Request-ID الأصلية ومعلومات النتيجة المُعادة. استعد النتائج الموجودة والمملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تُعِد إرسال طلب التوليد أو التعديل، ولا تنشئ عنوان URL للاستعلام الدوري من operation_id." }, "material_combinations": [ { "content_types": [ "application/json", "multipart/form-data" ], "file_id_supported": false, "mode": "text_to_image", "multipart_part_read_limit_bytes": 20971520, "optional_mask": { "json": "mask.image_url", "multipart": "mask" }, "reference_representations": { "json": "images[].image_url", "multipart": [ "image", "image[]", "image[index]" ] }, "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_image" ], "outputs": { "all_results": "احفظ كل عنصر بيانات. فك ترميز كل b64_json أو اجلب محتوى كل عنوان URL موقّع مُعاد. اختر امتداد اسم الملف بناءً على نوع MIME والبايتات الفعلية.", "family": "image", "fields": [ { "description": null, "name": "created", "type": "integer" }, { "description": null, "name": "data[].url", "type": "string" }, { "description": null, "name": "data[].b64_json", "type": "base64 string" }, { "description": null, "name": "usage", "type": "object" } ], "format": "actual validated raster MIME" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "gpt-image-2.5-sunburst-2026-09-08" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "url", "b64_json" ], "enum_known": true, "name": "response_format", "required": false, "type": "string" }, { "availability": "source_interface", "default": false, "default_known": true, "enum": null, "enum_known": false, "name": "stream", "required": false, "type": "boolean" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "size", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "quality", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "background", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_format", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "output_compression", "required": false, "type": "integer" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "moderation", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_fidelity", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "style", "required": false, "type": "string" }, { "availability": "model_dependent", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "partial_images", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [ "images[].file_id", "mask.file_id" ] }, "hints": [ "بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب." ], "input": { "content_type": "application/json", "material_types": [ "text" ], "optional_controls": null, "required": [ "model", "prompt" ] }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If an image generation or edit result requires a check, keep the original operation_id/X-Client-Request-ID and returned result information. Recover existing owned results through the media library using actual task_id or asset_id values. Do not resubmit the generation/edit request or construct a polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/images/generations" }, "operation_modes": [ "images" ], "output": { "family": [ "image" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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\": \"gpt-image-2.5-sunburst-2026-09-08\", \"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\"