# توليد الصور في Codex App (مهارة api-image)

> ثبّت مهارة api-image المجتمعية في Codex App لاستعادة توليد الصور في وضع API — مع LMU AI يكفي الإبقاء على ملف auth.json، ثم اطلب بلغة عادية التحويل من نص إلى صورة، ومن صورة إلى صورة، والتعديل الموضعي للصور.

URL: https://docs.lmuai.com/ar/docs/tools/codex-api-image



إنّ [api-image](https://github.com/yc-duan/api-image) مهارة مجتمعية (برخصة MIT): لا يتضمن Codex App في وضع API أداة توليد صور مدمجة، وبمجرد تثبيت هذه المهارة يصبح قادرًا على توليد الصور عبر نقطة نهاية الصور المتوافقة مع OpenAI التي تضبطها بنفسك. وهي تعيد استخدام المفتاح ونقطة النهاية الموجودين في `~/.codex`، وتكفي جملة واحدة في المحادثة.

<Callout type="warn" title="مهارة مجتمعية من طرف ثالث">
  تعمل على جهازك، وتقرأ المفتاح من `~/.codex/auth.json`، وترسل مطالبتك والصور المرجعية إلى المزوّد — فتأكد من أنك مرتاح لذلك قبل التثبيت. ويشير المؤلف أيضًا إلى أن التوافق يتفاوت بين المزوّدين، لذا اعتبر رسائل الخطأ الفعلية هي المصدر الموثوق.
</Callout>

***

## التحضير: أبقِ ملف auth.json [#التحضير-أبقِ-ملف-authjson]

تقرأ هذه المهارة المفتاح من `~/.codex/auth.json` (على Windows: `%USERPROFILE%\.codex\auth.json`). يضع [دليل Codex App](/ar/docs/tools/codex-app) المحدَّث المفتاح الآن في ترويسة طلب داخل `config.toml` ولم يعد بحاجة إلى `auth.json`، لكن لاستخدام هذه المهارة تحتاج إلى الإبقاء على ملف واحد يحتوي على المفتاح نفسه:

```json
{
  "OPENAI_API_KEY": "your sk- key generated in the console"
}
```

إن كنت قد أنشأت `auth.json` سابقًا بالدليل القديم، فاتركه كما هو.

***

## التثبيت: جملة واحدة إلى Codex [#التثبيت-جملة-واحدة-إلى-codex]

افتح Codex App وقل له فقط:

> ثبّت المهارة من [https://github.com/yc-duan/api-image](https://github.com/yc-duan/api-image) — أريد توليد الصور عبر واجهة OpenAI image 2 القياسية؛ انظر تعليمات الاستخدام على [https://github.com/yc-duan/api-image](https://github.com/yc-duan/api-image)

سيضع Codex المستودع بنفسه في `~/.codex/skills/api-image` (أو `%USERPROFILE%\.codex\skills\api-image` على Windows)؛ ثم **أعد تشغيل Codex App** بعد ذلك.

والتثبيت اليدوي ممكن أيضًا:

```bash
git clone https://github.com/yc-duan/api-image.git ~/.codex/skills/api-image
```

***

## الاستخدام: جملة واحدة أيضًا [#الاستخدام-جملة-واحدة-أيضًا]

| ما تريده         | قل هذا                                                                                                                    |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------- |
| من نص إلى صورة   | استخدم api-image لتوليد صورة سينمائية بمقاس 2048x1152: شارع في طوكيو ليلًا تحت المطر، انعكاسات النيون، بأسلوب تصوير واقعي |
| من صورة إلى صورة | باستخدام تركيب هذه الصورة ووضعية الشخص فيها كمرجع، ولّد رسمًا توضيحيًا دافئ الأجواء — احتفظ بوضعية الشخص ولا تنسخ الأصل   |
| التعديل الموضعي  | غيّر الكوب الأحمر في هذه الصورة إلى اللون الأخضر، مع الحفاظ على الشكل والتركيب والإضاءة الأصلية                           |
| خيارات صريحة     | استخدم api-image لتوليد رسم توضيحي مسطّح بمقاس 1024x1024، بجودة low، وصورتين، مع الحفظ إلى ./public/cover.png             |

القيم الافتراضية هي `gpt-image-2` و`2048x1152` وجودة high وصورة واحدة؛ ويمكن تغيير المقاس والجودة والعدد ومسار الإخراج كلها من داخل المحادثة مباشرة. ويُحفظ الناتج افتراضيًا في مجلد العمل الحالي (`provider-image-<timestamp>.png`).

***

## ملاحظات [#ملاحظات]

* **مع LMU AI، يكفي الإبقاء على `auth.json`**: تقرأ المهارة `auth.json` (المفتاح) و`config.toml` (نقطة النهاية)، وهو ما يقابل نقطتي النهاية الكاملتين `https://api.lmuai.com/v1/images/generations` و`/v1/images/edits`
* `model_not_found` / 403: المجموعة التابعة لمفتاحك لا تتضمن موديل الصور — راجع "الموديلات المتاحة" في لوحة التحكم أو انتقل إلى مجموعة أخرى
* لا يدعم `gpt-image-2` الخلفيات الشفافة، وقد يُوحّد الطرف العلوي المقاسات المطلوبة، لذا اعتمد على الناتج الفعلي