OpenAI: GPT Image 1

يولّد GPT Image 1 الصور ويحرّرها من النصوص والمدخلات البصرية، بما يشمل التكوينات التي تقودها المراجع والتغييرات باستخدام الأقنعة. يدعم أمانة مدخلات قابلة للاختيار وأحجام إطار قياسية وخلفيات شفافة وإخراج PNG أو JPEG أو WebP.

Ailoot Ultra · الصور POST /v1/images/generations openai/gpt-image-1

عن النموذج

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

GPT Image 1 هو نموذج صور من OpenAI يدعم تعدد الوسائط في بنيته الأصلية، ويقبل مدخلات نصية وصورية وينتج صورًا. يمكنه توليد مشهد جديد أو استخدام صور مرجعية لتشكيل تكوين أو تحرير مادة موجودة عبر تعليمة جديدة. تشمل الأعمال العملية الرسوم التوضيحية وصور المنتجات ومفاهيم التصميم والتغييرات المحلية التي يوجّهها قناع. هذا هو الإصدار المسمّى GPT Image 1، المنفصل عن Image 1 Mini وImage 1.5 وإصدارات GPT Image اللاحقة.

جهّز موجزًا يحدد الموضوع والبيئة والتكوين والإضاءة والأسلوب البصري. وإذا احتاجت المهمة إلى نص مرئي، فأدرج الصياغة الدقيقة واشرح التسلسل البصري والموضع المقصودين لها. ولتكوين مرجعي، امنح كل صورة دورًا واضحًا، مثل منتج أو بيئة أو معالجة بصرية. يتيح مسارا التوليد والتحرير المباشران تعليمة حتى 32,000 محرف ومن نتيجة صورية واحدة إلى عشر. قارن النسخ المُرجَعة بالموجز نفسه واحتفظ بالمادة المختارة للعمل اللاحق.

يمكن للتحرير استخدام ما يصل إلى ست عشرة صورة مرجعية. يدعم GPT Image 1 قيمتَي low وhigh لـ input_fidelity، مع low افتراضيًا. يؤثر هذا التحكم في الجهد المبذول للحفاظ على سمات صورة المصدر وأسلوبها؛ وهو منفصل عن جودة التصيير وحجم الإخراج. يفيد التحرير عالي الأمانة عندما تكون تفاصيل المصدر مهمة، لكنه لا يضمن بقاء كل تفصيل مميّز مطابقًا. حدّد ما ينبغي الاحتفاظ به وما يمكن تغييره بدلًا من الاعتماد على إعداد الأمانة وحده.

يحدد التحرير بالقناع منطقة لتعديلها. جهّز المصدر والقناع بالصيغة والأبعاد نفسها، وبحجم أقل من 50 MB وفق متطلبات الدليل، مع قناة ألفا في القناع. ومع صور مصدرية متعددة، يُطبّق القناع على الأولى. يمكن لموجز تعديل مفيد أن يطلب لونًا مختلفًا للجدار مع الاحتفاظ بالأثاث وزاوية الكاميرا والإضاءة. يستخدم النموذج القناع توجيهًا دون وعد بحد دقيق، لذا افحص المنطقة المتغيرة ومحيطها معًا.

أحجام الإخراج القياسية الموثّقة هي 1024 × 1024 و1536 × 1024 و1024 × 1536 بكسل، مع اختيار الحجم تلقائيًا حيثما يكون مدعومًا. الجودة low أو medium أو high أو auto. يستخدم GPT Image 1 هذه الإطارات القياسية ومستويات جودة حتى high. اختر الإطار القياسي وفق العرض المقصود ومستوى التفاصيل وفق غرض المادة.

PNG الإخراج الافتراضي، مع بديلَي JPEG وWebP. يتاح ضغط من 0 إلى 100 لـ JPEG وWebP. تدعم خيارات الخلفية الشفافة والمعتمة والتلقائية احتياجات تسليم مختلفة؛ وتتطلب الشفافية PNG أو WebP. ولرسم معزول، استخدم صيغة تحتفظ بقناة ألفا قبل وضعه في تخطيط لاحق. ولمشهد مكتمل، احتفظ بالخلفية وعلاقة الموضوع بها ضمن الموجز.

توثّق OpenAI التوليد والتحرير مباشرةً، وتشمل بطاقة النموذج أيضًا استخدام الصور حواريًا. وللعمل التكراري، احتفظ بالنتيجة المختارة مصدرًا لتغيير لاحق بدلًا من اختيار نسخة أخرى ضمنيًا. يوثّق مرجع الصور البث مع ما يصل إلى ثلاث صور جزئية؛ وهي تعرض التقدم ولا تمثل مواد مكتملة إضافية. احتفظ بالصورة المكتملة والموجز معًا كي تشير التعديلات اللاحقة إلى التكوين الفعلي. وتدعم واجهة الشركة المصنّعة أيضًا المعالجة الدفعية.

قد يظل النموذج يواجه صعوبة في وضع النص بدقة والتخطيطات شديدة التنظيم والاتساق بين الموضوعات المتكررة. افحص الحروف وحدود العناصر والمعالجة اللونية والتفاصيل التي تعرّف المواد المصدرية بالحجم المقصود. وإذا احتاج تعديل إلى تحسين، فصِف عدم التطابق المرئي والعناصر المطلوب الحفاظ عليها. يفيد GPT Image 1 ضمن تسلسل ملموس من التوليد والتحرير الذي تقوده المراجع وإعداد المواد، مع إبقاء أحجامه القياسية وأمانة مدخلاته القابلة للاختيار متميزة عن الإصدارات الأخرى.

Ailoot Ultra · الصور POST /v1/images/generations openai/gpt-image-1

openai/gpt-image-1

OpenAI /openai/gpt-image-1

البداية

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

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

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

الإدخال: text, image
الإخراج: image

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود openai/gpt-image-1	القيمة الافتراضية—
الحقل`prompt`	النوع`string`	المتطلبمطلوب	القيم والحدود الحد الأدنى للطول: ⁦1⁩	القيمة الافتراضية—
الحقل`aspect_ratio`	النوع`string`	المتطلباختياري	القيم والحدود 1:1, 3:2, 2:3, auto	القيمة الافتراضية—
الحقل`quality`	النوع`string`	المتطلباختياري	القيم والحدود auto, low, medium, high	القيمة الافتراضية—
الحقل`background`	النوع`string`	المتطلباختياري	القيم والحدود auto, transparent, opaque	القيمة الافتراضية—
الحقل`n`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦1⁩ الحد الأقصى: ⁦10⁩	القيمة الافتراضية—
الحقل`input_references`	النوع`array`	المتطلباختياري	القيم والحدود الحد الأدنى للعناصر: ⁦0⁩ الحد الأقصى للعناصر: ⁦16⁩	القيمة الافتراضية—
الحقل`output_compression`	النوع`integer`	المتطلباختياري	القيم والحدود الحد الأدنى: ⁦0⁩ الحد الأقصى: ⁦100⁩	القيمة الافتراضية—
الحقل`provider`	النوع`object`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, prompt
المعلمة`material_types`	المواصفاتtext, image

دورة الحياة: 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}

الباقات

كيفية احتساب الرسوم النهائية

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

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	الكمية المتوقعة	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	الكمية المتوقعة—	الرسوم الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتتكلفة التوليد التقديرية	جدول التعرفة—	الكمية المتوقعةتقدير لتوليد واحد	الرسوم الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.32768 تقدير قبل الإنشاء هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

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

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

Ailoot Ultra · الصور

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'openai/gpt-image-1', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        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"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

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

Ailoot Ultra · الصور

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

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

عمليات أخرى لقراءة المحتوى

قراءة الأصول الموجودة المملوكة لك

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

الاحتفاظ بكل النتائج المكتملة

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

احتفظ بالاستجابة كاملة وبجميع الترويسات، وبكل مخرج فعلي، وبالمعرّفات الأصلية المُعادة، وبجميع حقول الاستخدام. استعد العملية الأصلية دون إرسال طلب الإنشاء مجددًا.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بقيمة X-Client-Request-ID المُعادة للمطابقة. اقرأ فقط قيم task_id/asset_id الفعلية المُعادة أو مكتبة الوسائط المملوكة لك؛ ولا تنشئ عنوان URL لمهمة من معرّف العملية، ولا تُعِد إرسال طلب الإنشاء مطلقًا.

حقول الاستجابة

الحقل	النوع
الحقل`created`	النوع
الحقل`data[].url`	النوع
الحقل`data[].b64_json`	النوع
الحقل`usage`	النوع

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra openai/gpt-image-1

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

/v1/images

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

openai/gpt-image-1

FAQ · OpenAI: GPT Image 1

ما المدخلات والنتائج المتاحة؟: POST /v1/images/generations · openai/gpt-image-1: text, image → image
ما الحقول التي يستخدمها الطلب؟: POST /v1/images/generations · openai/gpt-image-1: model, prompt, aspect_ratio, quality, background, n, input_references, output_compression, provider
ما الحدود المطبقة؟: POST /v1/images/generations · openai/gpt-image-1: n.minimum: 1; n.maximum: 10; output_compression.minimum: 0; output_compression.maximum: 100

OpenAI: GPT Image 1