انتقل إلى المحتوى

توليد الصور وتعديلها عبر API بنماذج GPT

ولّد الصور وعدّلها بنماذج GPT للصور بصيغة OpenAI Images، مع كل الخيارات والأمثلة والأخطاء، وأين تقع صور Gemini.

آخر تحديث 2 أكتوبر 2026
في هذه الصفحة

ولّد صورة من وصف، أو عدّل صورة ترسلها. يخدم هذا العنوان نماذج GPT للصور بمفتاح لنماذج GPT، أما مفتاح Claude أو Gemini فيصله not_found_error. نماذج Gemini للصور تولّد الصور عبر generateContent.

POSThttps://api.5abeer.ai/v1/images/generations

عنوانان#

  • POST /v1/images/generations يولّد صورة من prompt، وجسم الطلب بصيغة JSON.
  • POST /v1/images/edits يعدّل الصورة التي ترسلها، وجسم الطلب بصيغة multipart/form-data يحمل الملف في image، ومعه mask إن أردت.

يجيب كلاهما بالحقل data، وهو قائمة صور بترميز Base64 في b64_json. فك الترميز واحفظ الصورة ملفًا بالصيغة التي اخترتها في output_format.

المصادقة#

أرسل مفتاحك في الترويسة Authorization بكلمة Bearer يليها المفتاح، مع العنوان الأساسي المتوافق مع OpenAI. مكتبات OpenAI تستدعي هذين العنوانين عبر client.images.generate وclient.images.edit.

مثال سريع#

curl --request POST "https://api.5abeer.ai/v1/images/generations" \
  --header "Authorization: Bearer $KHABEER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model":"gpt-image-1","prompt":"اكتب فكرة منتج في سطر واحد","size":"1024x1024","quality":"medium"}'
الرد
{
  "created": 1759400000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo…"
    }
  ]
}

المفتاح يُقرأ من متغير البيئة ⁦KHABEER_API_KEY⁩، فلا يظهر في الكود.

المعاملات#

مدعوم أي أننا نمرّره إلى نموذج الصور؛ ويُرفض أي أن الطلب يفشل، وهنا لأن المفتاح لمزوّد آخر.

المعاملالوصفClaudeGPTGemini
modelstringمطلوبمعرّف نموذج الصور كما في قائمة النماذج.ClaudeيُرفضGPTمدعومGeminiيُرفض
promptstringمطلوبوصف الصورة المطلوبة أو التعديل.ClaudeيُرفضGPTمدعومGeminiيُرفض
imagefileفي التعديل فقط: الصورة الأصلية، ملفًا في نموذج متعدد الأجزاء.ClaudeيُرفضGPTمدعومGeminiيُرفض
maskfileفي التعديل فقط: قناع شفاف يحدد المنطقة التي تتغير.ClaudeيُرفضGPTمدعومGeminiيُرفض
sizestringالمقاس، مثل 1024x1024 أو 1536x1024 أو auto.ClaudeيُرفضGPTمدعومGeminiيُرفض
qualitystringالجودة: low أو medium أو high أو auto.ClaudeيُرفضGPTمدعومGeminiيُرفض
nintegerعدد الصور، وأقلّه 1.ClaudeيُرفضGPTمدعومGeminiيُرفض
backgroundstringالخلفية: transparent أو opaque أو auto.ClaudeيُرفضGPTمدعومGeminiيُرفض
output_formatstringصيغة الملف: png أو jpeg أو webp.ClaudeيُرفضGPTمدعومGeminiيُرفض
output_compressionintegerنسبة الضغط من 0 إلى 100 مع jpeg وwebp.ClaudeيُرفضGPTمدعومGeminiيُرفض
moderationstringمستوى فلترة المحتوى: auto أو low.ClaudeيُرفضGPTمدعومGeminiيُرفض

أمثلة#

توليد صورة#

curl https://api.5abeer.ai/v1/images/generations \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A minimal orange logo for a note-taking app.",
    "size": "1024x1024",
    "quality": "medium"
  }'
شكل الرد
{
  "created": 1790000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 272,
    "total_tokens": 286
  }
}

خلفية شفافة وصيغة الملف#

curl https://api.5abeer.ai/v1/images/generations \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A minimal orange logo for a note-taking app.",
    "size": "1024x1024",
    "quality": "high",
    "n": 1,
    "background": "transparent",
    "output_format": "webp",
    "output_compression": 80,
    "moderation": "auto"
  }'
شكل الرد
{
  "created": 1790000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 272,
    "total_tokens": 286
  }
}

تعديل صورة#

curl https://api.5abeer.ai/v1/images/edits \
  -H "Authorization: Bearer $KHABEER_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Make the background light blue." \
  -F "image=@logo.png" \
  -F "mask=@mask.png" \
  -F "size=1024x1024"
شكل الرد
{
  "created": 1790000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
    }
  ],
  "usage": {
    "input_tokens": 14,
    "output_tokens": 272,
    "total_tokens": 286
  }
}

الطلب أعلاه جُرِّب على بيئة الاختبار المحلية يوم 2026-10-02؛ الرد يوضح الشكل، والنص فيه مثال.

الأخطاء#

نماذج الصور#

لكل مليون توكن

السعر الرسمي من صفحة المزوّد، بتاريخ 19 أكتوبر 2026.

كل النماذج والأسعار